home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / dist / fw_qt3.idb / usr / freeware / Qt / doc / html / propertydocs.z / propertydocs
Text File  |  2002-04-08  |  301KB  |  4,720 lines

  1. <!DOCTYPE PROP><PROP>
  2. <property>
  3.     <name>QAction::accel</name>
  4.     <doc href="qaction.html#accel-prop"> <p>This property holds the action's accelerator key.
  5. <p>The keycodes can be found in <a href="qt.html#Key-enum">Qt::Key</a> and <a href="qt.html#Modifier-enum">Qt::Modifier</a>. There is no default accelerator key.
  6. <p> 
  7. <p>Set this property's value with <a href="qaction.html#setAccel">setAccel</a>() and get this property's value with <a href="qaction.html#accel">accel</a>().
  8. </doc>
  9. </property>
  10. <property>
  11.     <name>QAction::enabled</name>
  12.     <doc href="qaction.html#enabled-prop"> <p>This property holds whether the action is enabled.
  13. <p>Disabled actions can't be chosen by the user. They don't
  14. disappear from the menu/tool bar but are displayed in a way which
  15. indicates that they are unavailable, e.g. they might be displayed
  16. greyed out.
  17. <p> What's this? help on disabled actions is still available
  18. provided the <a href="qaction.html#whatsThis-prop">QAction::whatsThis</a> property is set.
  19. <p> 
  20. <p>Set this property's value with <a href="qaction.html#setEnabled">setEnabled</a>() and get this property's value with <a href="qaction.html#isEnabled">isEnabled</a>().
  21. </doc>
  22. </property>
  23. <property>
  24.     <name>QAction::iconSet</name>
  25.     <doc href="qaction.html#iconSet-prop"> <p>This property holds the action's icon.
  26. <p>The icon is used as the tool button icon and in the menu to the left
  27. of the menu text. There is no default icon.
  28. <p> (See the action/toggleaction/toggleaction.cpp example.)
  29. <p> 
  30. <p>Set this property's value with <a href="qaction.html#setIconSet">setIconSet</a>() and get this property's value with <a href="qaction.html#iconSet">iconSet</a>().
  31. </doc>
  32. </property>
  33. <property>
  34.     <name>QAction::menuText</name>
  35.     <doc href="qaction.html#menuText-prop"> <p>This property holds the action's menu text.
  36. <p>If the action is added to a menu the menu option will consist of
  37. the icon (if there is one), the menu text and the accelerator (if
  38. there is one). If the menu text is not explicitly set in the
  39. constructor or by using <a href="qaction.html#setMenuText">setMenuText</a>() the action's description
  40. text will be used as the menu text. There is no default menu text.
  41. <p> <p>See also <a href="qaction.html#text-prop">text</a>.
  42.  
  43. <p>Set this property's value with <a href="qaction.html#setMenuText">setMenuText</a>() and get this property's value with <a href="qaction.html#menuText">menuText</a>().
  44. </doc>
  45. </property>
  46. <property>
  47.     <name>QAction::on</name>
  48.     <doc href="qaction.html#on-prop">
  49. <p>This property holds whether a toggle action is on.
  50. <p>This property is always on (TRUE) for command actions and
  51. <a href="qactiongroup.html">QActionGroup</a>s; <a href="qaction.html#setOn">setOn</a>() has no effect on them. For action's where
  52. <a href="qaction.html#isToggleAction">isToggleAction</a>() is TRUE, this property's default value is off
  53. (FALSE).
  54. <p> <p>See also <a href="qaction.html#toggleAction-prop">toggleAction</a>.
  55.  
  56. <p>Set this property's value with <a href="qaction.html#setOn">setOn</a>() and get this property's value with <a href="qaction.html#isOn">isOn</a>().
  57. </doc>
  58. </property>
  59. <property>
  60.     <name>QAction::statusTip</name>
  61.     <doc href="qaction.html#statusTip-prop"> <p>This property holds the action's status tip.
  62. <p>The statusTip is displayed on all status bars that this action's
  63. toplevel parent widget provides.
  64. <p> If no status tip is defined, the action uses the tool tip text.
  65. <p> There is no default tooltip text.
  66. <p> <p>See also <a href="qaction.html#statusTip-prop">statusTip</a> and <a href="qaction.html#toolTip-prop">toolTip</a>.
  67.  
  68. <p>Set this property's value with <a href="qaction.html#setStatusTip">setStatusTip</a>() and get this property's value with <a href="qaction.html#statusTip">statusTip</a>().
  69. </doc>
  70. </property>
  71. <property>
  72.     <name>QAction::text</name>
  73.     <doc href="qaction.html#text-prop"> <p>This property holds the action's descriptive text.
  74. <p>If <a href="qmainwindow.html#usesTextLabel-prop">QMainWindow::usesTextLabel</a> is TRUE, the text appears as a
  75. label in the relevant tool button. It also serves as the default text
  76. in menus and tool tips if these have not been specifically defined. There
  77. is no default text.
  78. <p> <p>See also <a href="qaction.html#menuText-prop">menuText</a>, <a href="qaction.html#toolTip-prop">toolTip</a> and <a href="qaction.html#statusTip-prop">statusTip</a>.
  79.  
  80. <p>Set this property's value with <a href="qaction.html#setText">setText</a>() and get this property's value with <a href="qaction.html#text">text</a>().
  81. </doc>
  82. </property>
  83. <property>
  84.     <name>QAction::toggleAction</name>
  85.     <doc href="qaction.html#toggleAction-prop">
  86. <p>This property holds whether the action is a toggle action.
  87. <p>A toggle action is one which has an on/off state. For example a Bold
  88. toolbar button is either on or off. An action which is not a toggle
  89. action is a command action; a command action is simply executed.
  90. This property's default is FALSE.
  91. <p> In some situations, the state of one toggle action should depend on
  92. the state of others. For example, "Left Align", "Center" and "Right
  93. Align" toggle actions are mutually exclusive. To achieve exclusive
  94. toggling, add the relevant toggle actions to a <a href="qactiongroup.html">QActionGroup</a> with the
  95. <a href="qactiongroup.html#exclusive-prop">QActionGroup::exclusive</a> property set to TRUE.
  96. <p> 
  97. <p>Set this property's value with <a href="qaction.html#setToggleAction">setToggleAction</a>() and get this property's value with <a href="qaction.html#isToggleAction">isToggleAction</a>().
  98. </doc>
  99. </property>
  100. <property>
  101.     <name>QAction::toolTip</name>
  102.     <doc href="qaction.html#toolTip-prop">
  103. <p>This property holds the action's tool tip.
  104. <p>This text is used for the tool tip. If no status tip has been set
  105. the tool tip will be used for the status tip.
  106. <p> If no tool tip is specified the action's text is used, and if that
  107. hasn't been specified the description text is used as the tool tip
  108. text.
  109. <p> There is no default tool tip text.
  110. <p> <p>See also <a href="qaction.html#statusTip-prop">statusTip</a> and <a href="qaction.html#accel-prop">accel</a>.
  111.  
  112. <p>Set this property's value with <a href="qaction.html#setToolTip">setToolTip</a>() and get this property's value with <a href="qaction.html#toolTip">toolTip</a>().
  113. </doc>
  114. </property>
  115. <property>
  116.     <name>QAction::whatsThis</name>
  117.     <doc href="qaction.html#whatsThis-prop"><p>This property holds the action's "What's This?" help text.
  118. <p>The whats this text is used to provide a brief description of the
  119. action. The text may contain rich text (i.e. HTML tags -- see
  120. <a href="qstylesheet.html">QStyleSheet</a> for the list of supported tags). There is no default
  121. "What's This" text.
  122. <p> <p>See also <a href="qwhatsthis.html">QWhatsThis</a>.
  123.  
  124. <p>Set this property's value with <a href="qaction.html#setWhatsThis">setWhatsThis</a>() and get this property's value with <a href="qaction.html#whatsThis">whatsThis</a>().
  125. </doc>
  126. </property>
  127. <property>
  128.     <name>QActionGroup::exclusive</name>
  129.     <doc href="qactiongroup.html#exclusive-prop"> <p>This property holds whether the action group does exclusive toggling.
  130. <p>If exclusive is TRUE only one toggle action in the action group can
  131. ever be active at any one time. If the user chooses another toggle
  132. action in the group the one they chose becomes active and the one
  133. that was active becomes inactive. By default this property is FALSE.
  134. <p> <p>See also <a href="qaction.html#toggleAction-prop">QAction::toggleAction</a>.
  135.  
  136. <p>Set this property's value with <a href="qactiongroup.html#setExclusive">setExclusive</a>() and get this property's value with <a href="qactiongroup.html#isExclusive">isExclusive</a>().
  137. </doc>
  138. </property>
  139. <property>
  140.     <name>QActionGroup::usesDropDown</name>
  141.     <doc href="qactiongroup.html#usesDropDown-prop">  <p>This property holds whether the group's actions are displayed in a subwidget of the widgets the action group is added to.
  142. <p>Exclusive action groups added to a toolbar display their actions in
  143. a combobox with the action's <a href="qaction.html#text-prop">QAction::text</a> and <a href="qaction.html#iconSet-prop">QAction::iconSet</a> properties shown. Non-exclusive groups are
  144. represented by a tool button showing their <a href="qaction.html#iconSet-prop">QAction::iconSet</a> and
  145. -- depending on <a href="qmainwindow.html#usesTextLabel">QMainWindow::usesTextLabel</a>() -- <a href="qaction.html#text">text</a>() property.
  146. <p> In a popup menu the member actions are displayed in a
  147. submenu.
  148. <p> Changing usesDropDown only effects <em>subsequent</em> calls to <a href="qactiongroup.html#addTo">addTo</a>().
  149. <p> This property's default is FALSE.
  150. <p> 
  151. <p>Set this property's value with <a href="qactiongroup.html#setUsesDropDown">setUsesDropDown</a>() and get this property's value with <a href="qactiongroup.html#usesDropDown">usesDropDown</a>().
  152. </doc>
  153. </property>
  154. <property>
  155.     <name>QButton::accel</name>
  156.     <doc href="qbutton.html#accel-prop"> <p>This property holds the accelerator associated with the button.
  157. <p>This property is 0 if there is no accelerator set. If you set
  158. this property to 0 then any current accelerator is removed.
  159.  
  160. <p>Set this property's value with <a href="qbutton.html#setAccel">setAccel</a>() and get this property's value with <a href="qbutton.html#accel">accel</a>().
  161. </doc>
  162. </property>
  163. <property>
  164.     <name>QButton::autoRepeat</name>
  165.     <doc href="qbutton.html#autoRepeat-prop"> <p>This property holds whether autoRepeat is enabled.
  166. <p>If autoRepeat is enabled then the <a href="qbutton.html#clicked">clicked</a>() signal is emitted at
  167. regular intervals if the button is down.  This property has
  168. no effect on toggle buttons. autoRepeat is off by default.
  169.  
  170. <p>Set this property's value with <a href="qbutton.html#setAutoRepeat">setAutoRepeat</a>() and get this property's value with <a href="qbutton.html#autoRepeat">autoRepeat</a>().
  171. </doc>
  172. </property>
  173. <property>
  174.     <name>QButton::autoResize</name>
  175.     <doc href="qbutton.html#autoResize-prop"> <p>This property holds whether autoResize is enabled.
  176. <p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  177. <p> If autoResize is enabled then the button will resize itself
  178. whenever the contents are changed.
  179.  
  180. <p>Set this property's value with <a href="qbutton.html#setAutoResize">setAutoResize</a>() and get this property's value with <a href="qbutton.html#autoResize">autoResize</a>().
  181. </doc>
  182. </property>
  183. <property>
  184.     <name>QButton::down</name>
  185.     <doc href="qbutton.html#down-prop"> <p>This property holds whether the button is pressed.
  186. <p>If this property is TRUE, the button is set to be pressed down.  The
  187. signals <a href="qbutton.html#pressed">pressed</a>() and <a href="qbutton.html#clicked">clicked</a>() are not emitted if you set this
  188. property to TRUE. The default is FALSE.
  189.  
  190. <p>Set this property's value with <a href="qbutton.html#setDown">setDown</a>() and get this property's value with <a href="qbutton.html#isDown">isDown</a>().
  191. </doc>
  192. </property>
  193. <property>
  194.     <name>QButton::exclusiveToggle</name>
  195.     <doc href="qbutton.html#exclusiveToggle-prop"> <p>This property holds whether the button is an exclusive toggle.
  196. <p>If this property is TRUE and the button is in a <a href="qbuttongroup.html">QButtonGroup</a>, the
  197. button can only be toggled off by another one being toggled on. The
  198. default is FALSE.
  199.  
  200. <p>Get this property's value with <a href="qbutton.html#isExclusiveToggle">isExclusiveToggle</a>().
  201. </doc>
  202. </property>
  203. <property>
  204.     <name>QButton::on</name>
  205.     <doc href="qbutton.html#on-prop"> <p>This property holds whether the button is toggled.
  206. <p>This property should only be set for toggle buttons.
  207.  
  208. <p>Get this property's value with <a href="qbutton.html#isOn">isOn</a>().
  209. </doc>
  210. </property>
  211. <property>
  212.     <name>QButton::pixmap</name>
  213.     <doc href="qbutton.html#pixmap-prop"> <p>This property holds the pixmap shown on the button.
  214. <p>If the pixmap is monochrome (i.e., it is a <a href="qbitmap.html">QBitmap</a> or its <a href="qpixmap.html#depth">depth</a> is 1) and it does not have a mask,
  215. this property will set the pixmap to be its own mask. The purpose of
  216. this is to draw transparent bitmaps which are important for
  217. toggle buttons, for example.
  218. <p> <a href="qbutton.html#pixmap">pixmap</a>() returns 0 if no pixmap was set.
  219.  
  220. <p>Set this property's value with <a href="qbutton.html#setPixmap">setPixmap</a>() and get this property's value with <a href="qbutton.html#pixmap">pixmap</a>().
  221. </doc>
  222. </property>
  223. <property>
  224.     <name>QButton::text</name>
  225.     <doc href="qbutton.html#text-prop"> <p>This property holds the text shown on the button.
  226. <p>This property will return a null string if the button has
  227. no text.  If the text has an ampersand ('&amp;') in it, then an
  228. accelerator is automatically created for it using the
  229. character after the '&amp;' as the accelerator key.
  230. <p> There is no default text.
  231.  
  232. <p>Set this property's value with <a href="qbutton.html#setText">setText</a>() and get this property's value with <a href="qbutton.html#text">text</a>().
  233. </doc>
  234. </property>
  235. <property>
  236.     <name>QButton::toggleButton</name>
  237.     <doc href="qbutton.html#toggleButton-prop"> <p>This property holds whether the button is a toggle button.
  238. <p>The default value is FALSE.
  239.  
  240. <p>Get this property's value with <a href="qbutton.html#isToggleButton">isToggleButton</a>().
  241. </doc>
  242. </property>
  243. <property>
  244.     <name>QButton::toggleState</name>
  245.     <doc href="qbutton.html#toggleState-prop"> <p>This property holds whether the button is toggled.
  246. <p>If this is property is changed then it does not cause the button
  247. to be repainted.
  248.  
  249. <p>Get this property's value with <a href="qbutton.html#state">state</a>().
  250. </doc>
  251. </property>
  252. <property>
  253.     <name>QButton::toggleType</name>
  254.     <doc href="qbutton.html#toggleType-prop"> <p>This property holds the type of toggle on the button.
  255. <p>The default toggle type is SingleShot.
  256.  
  257. <p>Get this property's value with <a href="qbutton.html#toggleType">toggleType</a>().
  258. </doc>
  259. </property>
  260. <property>
  261.     <name>QButtonGroup::exclusive</name>
  262.     <doc href="qbuttongroup.html#exclusive-prop"> <p>This property holds whether the button group is exclusive.
  263. <p>If this property is TRUE, then the buttons in the group are
  264. toggled, and to untoggle a button you must click on another button in
  265. the group. The default value is FALSE.
  266.  
  267. <p>Set this property's value with <a href="qbuttongroup.html#setExclusive">setExclusive</a>() and get this property's value with <a href="qbuttongroup.html#isExclusive">isExclusive</a>().
  268. </doc>
  269. </property>
  270. <property>
  271.     <name>QButtonGroup::radioButtonExclusive</name>
  272.     <doc href="qbuttongroup.html#radioButtonExclusive-prop"> <p>This property holds whether the radiobuttons in the group are exclusive.
  273. <p>If this property is TRUE (the default), the radiobuttons in the
  274. group are treated exclusively.
  275.  
  276. <p>Set this property's value with <a href="qbuttongroup.html#setRadioButtonExclusive">setRadioButtonExclusive</a>() and get this property's value with <a href="qbuttongroup.html#isRadioButtonExclusive">isRadioButtonExclusive</a>().
  277. </doc>
  278. </property>
  279. <property>
  280.     <name>QCheckBox::checked</name>
  281.     <doc href="qcheckbox.html#checked-prop"> <p>This property holds whether the checkbox is checked.
  282. <p>The default is unchecked, i.e. FALSE.
  283.  
  284. <p>Set this property's value with <a href="qcheckbox.html#setChecked">setChecked</a>() and get this property's value with <a href="qcheckbox.html#isChecked">isChecked</a>().
  285. </doc>
  286. </property>
  287. <property>
  288.     <name>QCheckBox::tristate</name>
  289.     <doc href="qcheckbox.html#tristate-prop"> <p>This property holds whether the checkbox is a tri-state checkbox.
  290. <p>The default is two-state, i.e. tri-state is FALSE.
  291.  
  292. <p>Set this property's value with <a href="qcheckbox.html#setTristate">setTristate</a>() and get this property's value with <a href="qcheckbox.html#isTristate">isTristate</a>().
  293. </doc>
  294. </property>
  295. <property>
  296.     <name>QComboBox::autoCompletion</name>
  297.     <doc href="qcombobox.html#autoCompletion-prop"> <p>This property holds whether auto-completion is enabled.
  298. <p>This property can only be set for editable comboboxes, for non-editable
  299. comboboxes it has no effect. It is FALSE by default.
  300.  
  301. <p>Set this property's value with <a href="qcombobox.html#setAutoCompletion">setAutoCompletion</a>() and get this property's value with <a href="qcombobox.html#autoCompletion">autoCompletion</a>().
  302. </doc>
  303. </property>
  304. <property>
  305.     <name>QComboBox::autoResize</name>
  306.     <doc href="qcombobox.html#autoResize-prop"> <p>This property holds whether auto resize is enabled.
  307. <p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  308. <p> If this property is set to TRUE then the combobox will resize itself
  309. whenever its contents change. The default is FALSE.
  310.  
  311. <p>Set this property's value with <a href="qcombobox.html#setAutoResize">setAutoResize</a>() and get this property's value with <a href="qcombobox.html#autoResize">autoResize</a>().
  312. </doc>
  313. </property>
  314. <property>
  315.     <name>QComboBox::count</name>
  316.     <doc href="qcombobox.html#count-prop"> <p>This property holds the number of items in the combobox.
  317. <p>
  318. <p>Get this property's value with <a href="qcombobox.html#count">count</a>().
  319. </doc>
  320. </property>
  321. <property>
  322.     <name>QComboBox::currentItem</name>
  323.     <doc href="qcombobox.html#currentItem-prop"> <p>This property holds the index of the current item in the combobox.
  324. <p>
  325. <p>Set this property's value with <a href="qcombobox.html#setCurrentItem">setCurrentItem</a>() and get this property's value with <a href="qcombobox.html#currentItem">currentItem</a>().
  326. </doc>
  327. </property>
  328. <property>
  329.     <name>QComboBox::currentText</name>
  330.     <doc href="qcombobox.html#currentText-prop"> <p>This property holds the text of the combobox's current item.
  331. <p>
  332. <p>Set this property's value with <a href="qcombobox.html#setCurrentText">setCurrentText</a>() and get this property's value with <a href="qcombobox.html#currentText">currentText</a>().
  333. </doc>
  334. </property>
  335. <property>
  336.     <name>QComboBox::duplicatesEnabled</name>
  337.     <doc href="qcombobox.html#duplicatesEnabled-prop"> <p>This property holds whether duplicates are allowed.
  338. <p>If the combobox is editable and the user enters some text in the
  339. lineedit of the combobox and presses Enter (and the
  340. <a href="qcombobox.html#insertionPolicy">insertionPolicy</a>() is different from NoInsertion), then what happens
  341. is as follows:
  342. <ul>
  343. <li> If the text is not already in the list, the text is inserted.
  344. <li> If the text is in the list and this property is TRUE (the
  345. default), the text is inserted.
  346. <li> If the text is in the list and this property is FALSE, the text
  347. is <em>not</em> inserted; instead the item which has matching text becomes
  348. the current item.
  349. </ul>
  350. <p> This property only affects user-interaction. You can use
  351. <a href="qcombobox.html#insertItem">insertItem</a>() to insert duplicates if you wish regardless of this
  352. setting.
  353. <p> 
  354. <p>Set this property's value with <a href="qcombobox.html#setDuplicatesEnabled">setDuplicatesEnabled</a>() and get this property's value with <a href="qcombobox.html#duplicatesEnabled">duplicatesEnabled</a>().
  355. </doc>
  356. </property>
  357. <property>
  358.     <name>QComboBox::editable</name>
  359.     <doc href="qcombobox.html#editable-prop"> <p>This property holds whether the combobox is editable.
  360. <p>This property's default is FALSE. Note that the combobox will be
  361. cleared if this property is set to TRUE for a 1.x Motif style
  362. combobox. To avoid this, use <a href="qcombobox.html#setEditable">setEditable</a>() before inserting any
  363. items. Also note that the 1.x version of Motif didn't have any
  364. editable comboboxes, so the combobox will change it's appearance
  365. to a 2.0 style Motif combobox is it is set to be editable.
  366.  
  367. <p>Set this property's value with <a href="qcombobox.html#setEditable">setEditable</a>() and get this property's value with <a href="qcombobox.html#editable">editable</a>().
  368. </doc>
  369. </property>
  370. <property>
  371.     <name>QComboBox::insertionPolicy</name>
  372.     <doc href="qcombobox.html#insertionPolicy-prop"> <p>This property holds the position of the items inserted by the user.
  373. <p>The default insertion policy is <a href="qcombobox.html#Policy-enum">AtBottom</a>.
  374.  
  375. <p>Set this property's value with <a href="qcombobox.html#setInsertionPolicy">setInsertionPolicy</a>() and get this property's value with <a href="qcombobox.html#insertionPolicy">insertionPolicy</a>().
  376. </doc>
  377. </property>
  378. <property>
  379.     <name>QComboBox::maxCount</name>
  380.     <doc href="qcombobox.html#maxCount-prop"> <p>This property holds the maximum number of items allowed in the combobox.
  381. <p>
  382. <p>Set this property's value with <a href="qcombobox.html#setMaxCount">setMaxCount</a>() and get this property's value with <a href="qcombobox.html#maxCount">maxCount</a>().
  383. </doc>
  384. </property>
  385. <property>
  386.     <name>QComboBox::sizeLimit</name>
  387.     <doc href="qcombobox.html#sizeLimit-prop"> <p>This property holds the maximum on-screen size of the combobox.
  388. <p>This is disregarded in Motif 1.x style.  The default limit is ten
  389. lines. If the number of items in the combobox is or grows larger than
  390. lines, a scrollbar is added.
  391.  
  392. <p>Set this property's value with <a href="qcombobox.html#setSizeLimit">setSizeLimit</a>() and get this property's value with <a href="qcombobox.html#sizeLimit">sizeLimit</a>().
  393. </doc>
  394. </property>
  395. <property>
  396.     <name>QDataBrowser::autoEdit</name>
  397.     <doc href="qdatabrowser.html#autoEdit-prop"> <p>This property holds whether the browser automatically applies edits.
  398. <p>The default value for this property is TRUE. When the user begins an
  399. insertion or an update on a form there are two possible outcomes when
  400. they navigate to another record:
  401. <p> <ul>
  402. <li> the insert or update is is performed -- this occurs if autoEdit is TRUE
  403. <li> the insert or update is discarded -- this occurs if autoEdit is FALSE
  404. </ul>
  405.  
  406. <p>Set this property's value with <a href="qdatabrowser.html#setAutoEdit">setAutoEdit</a>() and get this property's value with <a href="qdatabrowser.html#autoEdit">autoEdit</a>().
  407. </doc>
  408. </property>
  409. <property>
  410.     <name>QDataBrowser::boundaryChecking</name>
  411.     <doc href="qdatabrowser.html#boundaryChecking-prop"> <p>This property holds whether boundary checking is active.
  412. <p>When boundary checking is active (the default), signals are
  413. emitted indicating the current position of the default cursor.
  414. <p> <p>See also <a href="qdatabrowser.html#boundary">boundary</a>().
  415.  
  416. <p>Set this property's value with <a href="qdatabrowser.html#setBoundaryChecking">setBoundaryChecking</a>() and get this property's value with <a href="qdatabrowser.html#boundaryChecking">boundaryChecking</a>().
  417. </doc>
  418. </property>
  419. <property>
  420.     <name>QDataBrowser::confirmCancels</name>
  421.     <doc href="qdatabrowser.html#confirmCancels-prop"> <p>This property holds whether the browser confirms cancel operations.
  422. <p>If this property is TRUE, all cancels must be
  423. confirmed by the user through a message box (this behavior can be
  424. changed by overriding the <a href="qdatabrowser.html#confirmCancel">confirmCancel</a>() function), otherwise all
  425. cancels occur immediately. The default is FALSE.
  426. <p> <p>See also <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a> and <a href="qdatabrowser.html#confirmCancel">confirmCancel</a>().
  427.  
  428. <p>Set this property's value with <a href="qdatabrowser.html#setConfirmCancels">setConfirmCancels</a>() and get this property's value with <a href="qdatabrowser.html#confirmCancels">confirmCancels</a>().
  429. </doc>
  430. </property>
  431. <property>
  432.     <name>QDataBrowser::confirmDelete</name>
  433.     <doc href="qdatabrowser.html#confirmDelete-prop"> <p>This property holds whether the browser confirms deletions.
  434. <p>If this property is TRUE, the browser confirms deletions,
  435. otherwise deletions happen immediately.
  436. <p> <p>See also <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatabrowser.html#confirmUpdate-prop">confirmUpdate</a>, <a href="qdatabrowser.html#confirmInsert-prop">confirmInsert</a> and <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>().
  437.  
  438. <p>Set this property's value with <a href="qdatabrowser.html#setConfirmDelete">setConfirmDelete</a>() and get this property's value with <a href="qdatabrowser.html#confirmDelete">confirmDelete</a>().
  439. </doc>
  440. </property>
  441. <property>
  442.     <name>QDataBrowser::confirmEdits</name>
  443.     <doc href="qdatabrowser.html#confirmEdits-prop"> <p>This property holds whether the browser confirms edit operations.
  444. <p>If this property is TRUE, the browser confirms all edit operations
  445. (insertions, updates and deletions), otherwise all edit operations
  446. happen immediately. Confirmation is achieved by presenting the user
  447. with a message box -- this behavior can be changed by reimplementing
  448. the <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>() function,
  449. <p> <p>See also <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>(), <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatabrowser.html#confirmUpdate-prop">confirmUpdate</a> and <a href="qdatabrowser.html#confirmDelete-prop">confirmDelete</a>.
  450.  
  451. <p>Set this property's value with <a href="qdatabrowser.html#setConfirmEdits">setConfirmEdits</a>() and get this property's value with <a href="qdatabrowser.html#confirmEdits">confirmEdits</a>().
  452. </doc>
  453. </property>
  454. <property>
  455.     <name>QDataBrowser::confirmInsert</name>
  456.     <doc href="qdatabrowser.html#confirmInsert-prop"> <p>This property holds whether the data browser confirms insertions.
  457. <p>If this property is TRUE, the browser confirms insertions,
  458. otherwise insertions happen immediately.
  459. <p> <p>See also <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatabrowser.html#confirmUpdate-prop">confirmUpdate</a>, <a href="qdatabrowser.html#confirmDelete-prop">confirmDelete</a> and <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>().
  460.  
  461. <p>Set this property's value with <a href="qdatabrowser.html#setConfirmInsert">setConfirmInsert</a>() and get this property's value with <a href="qdatabrowser.html#confirmInsert">confirmInsert</a>().
  462. </doc>
  463. </property>
  464. <property>
  465.     <name>QDataBrowser::confirmUpdate</name>
  466.     <doc href="qdatabrowser.html#confirmUpdate-prop"> <p>This property holds whether the browser confirms updates.
  467. <p>If this property is TRUE, the browser confirms updates,
  468. otherwise updates happen immediately.
  469. <p> <p>See also <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatabrowser.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatabrowser.html#confirmDelete-prop">confirmDelete</a> and <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>().
  470.  
  471. <p>Set this property's value with <a href="qdatabrowser.html#setConfirmUpdate">setConfirmUpdate</a>() and get this property's value with <a href="qdatabrowser.html#confirmUpdate">confirmUpdate</a>().
  472. </doc>
  473. </property>
  474. <property>
  475.     <name>QDataBrowser::filter</name>
  476.     <doc href="qdatabrowser.html#filter-prop"> <p>This property holds the data browser's filter.
  477. <p>The filter applies to the data shown in the browser. Call <a href="qdatabrowser.html#refresh">refresh</a>() to
  478. apply the new filter. A filter is a string containing a SQL WHERE
  479. clause without the WHERE keyword, e.g. "id>1000", "name LIKE 'A%'".
  480. <p> There is no default filter.
  481. <p> <p>See also <a href="qdatabrowser.html#sort-prop">sort</a>.
  482.  
  483. <p> 
  484. <p>Set this property's value with <a href="qdatabrowser.html#setFilter">setFilter</a>() and get this property's value with <a href="qdatabrowser.html#filter">filter</a>().
  485. </doc>
  486. </property>
  487. <property>
  488.     <name>QDataBrowser::readOnly</name>
  489.     <doc href="qdatabrowser.html#readOnly-prop">  <p>This property holds whether the browser is read-only.
  490. <p>The default is FALSE, i.e. data can be edited.
  491. If the data browser is read-only, no database edits will be allowed.
  492. <p> 
  493. <p>Set this property's value with <a href="qdatabrowser.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qdatabrowser.html#isReadOnly">isReadOnly</a>().
  494. </doc>
  495. </property>
  496. <property>
  497.     <name>QDataBrowser::sort</name>
  498.     <doc href="qdatabrowser.html#sort-prop"> <p>This property holds the data browser's sort.
  499. <p>The data browser's sort affects the order in which records are
  500. viewed in the browser.  Call <a href="qdatabrowser.html#refresh">refresh</a>() to apply the new sort.
  501. <p> When retrieving the sort property, a string list is returned in the
  502. form 'fieldname order', e.g.  'id ASC', 'surname DESC'.
  503. <p> There is no default sort.
  504. <p> Note that if you want to iterate over the list, you should
  505. iterate over a copy, e.g.
  506. <pre>
  507.     <a href="qstringlist.html">QStringList</a> list = myDataBrowser.sort();
  508.     QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>();
  509.     while( it != list.<a href="qvaluelist.html#end">end</a>() ) {
  510.         myProcessing( *it );
  511.         ++it;
  512.     }
  513.     </pre>
  514.  
  515.  
  516. <p>Set this property's value with <a href="qdatabrowser.html#setSort">setSort</a>() and get this property's value with <a href="qdatabrowser.html#sort">sort</a>().
  517. </doc>
  518. </property>
  519. <property>
  520.     <name>QDataTable::autoEdit</name>
  521.     <doc href="qdatatable.html#autoEdit-prop"> <p>This property holds whether the data table automatically applies edits.
  522. <p>The default value for this property is TRUE. When the user begins an
  523. insert or update in the table there are two possible outcomes when they
  524. navigate to another record:
  525. <p> <ol type=1>
  526. <li> the insert or update is is performed -- this occurs if autoEdit is TRUE
  527. <li> the insert or update is abandoned -- this occurs if autoEdit is FALSE
  528. </ol>
  529. <p> 
  530. <p>Set this property's value with <a href="qdatatable.html#setAutoEdit">setAutoEdit</a>() and get this property's value with <a href="qdatatable.html#autoEdit">autoEdit</a>().
  531. </doc>
  532. </property>
  533. <property>
  534.     <name>QDataTable::confirmCancels</name>
  535.     <doc href="qdatatable.html#confirmCancels-prop"> <p>This property holds whether the data table confirms cancel operations.
  536. <p>If the confirmCancel property is active, all cancels must be
  537. confirmed by the user through a message box (this behavior can be
  538. changed by overriding the <a href="qdatatable.html#confirmCancel">confirmCancel</a>() function), otherwise all
  539. cancels occur immediately. The default is FALSE.
  540. <p> <p>See also <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a> and <a href="qdatatable.html#confirmCancel">confirmCancel</a>().
  541.  
  542. <p>Set this property's value with <a href="qdatatable.html#setConfirmCancels">setConfirmCancels</a>() and get this property's value with <a href="qdatatable.html#confirmCancels">confirmCancels</a>().
  543. </doc>
  544. </property>
  545. <property>
  546.     <name>QDataTable::confirmDelete</name>
  547.     <doc href="qdatatable.html#confirmDelete-prop"> <p>This property holds whether the data table confirms delete operations.
  548. <p>If the confirmDelete property is active, all deletions must be
  549. confirmed by the user through a message box (this behaviour can be
  550. changed by overriding the <a href="qdatatable.html#confirmEdit">confirmEdit</a>() function), otherwise all
  551. delete operations occur immediately.
  552. <p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a> and <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a>.
  553.  
  554. <p>Set this property's value with <a href="qdatatable.html#setConfirmDelete">setConfirmDelete</a>() and get this property's value with <a href="qdatatable.html#confirmDelete">confirmDelete</a>().
  555. </doc>
  556. </property>
  557. <property>
  558.     <name>QDataTable::confirmEdits</name>
  559.     <doc href="qdatatable.html#confirmEdits-prop"> <p>This property holds whether the data table confirms edit operations.
  560. <p>If the confirmEdits property is active, the data table confirms all
  561. edit operations (inserts, updates and deletes), otherwise all edit
  562. operations occur immediately.
  563. <p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a> and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>.
  564.  
  565. <p>Set this property's value with <a href="qdatatable.html#setConfirmEdits">setConfirmEdits</a>() and get this property's value with <a href="qdatatable.html#confirmEdits">confirmEdits</a>().
  566. </doc>
  567. </property>
  568. <property>
  569.     <name>QDataTable::confirmInsert</name>
  570.     <doc href="qdatatable.html#confirmInsert-prop"> <p>This property holds whether the data table confirms insert operations.
  571. <p>If the confirmInsert property is active, all insertions must be confirmed
  572. by the user through a message box (this behaviour can be changed by
  573. overriding the <a href="qdatatable.html#confirmEdit">confirmEdit</a>() function), otherwise all insert
  574. operations occur immediately.
  575. <p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a> and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>.
  576.  
  577. <p>Set this property's value with <a href="qdatatable.html#setConfirmInsert">setConfirmInsert</a>() and get this property's value with <a href="qdatatable.html#confirmInsert">confirmInsert</a>().
  578. </doc>
  579. </property>
  580. <property>
  581.     <name>QDataTable::confirmUpdate</name>
  582.     <doc href="qdatatable.html#confirmUpdate-prop"> <p>This property holds whether the data table confirms update operations.
  583. <p>If the confirmUpdate property is active, all updates must be confirmed
  584. by the user through a message box (this behaviour can be changed by
  585. overriding the <a href="qdatatable.html#confirmEdit">confirmEdit</a>() function), otherwise all update
  586. operations occur immediately.
  587. <p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a> and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>.
  588.  
  589. <p>Set this property's value with <a href="qdatatable.html#setConfirmUpdate">setConfirmUpdate</a>() and get this property's value with <a href="qdatatable.html#confirmUpdate">confirmUpdate</a>().
  590. </doc>
  591. </property>
  592. <property>
  593.     <name>QDataTable::dateFormat</name>
  594.     <doc href="qdatatable.html#dateFormat-prop"> <p>This property holds the format how date/time values are displayed.
  595. <p>The dateFormat property will be used to display date/time values in the
  596. table. The default value is 'Qt::LocalDate'.
  597.  
  598. <p>Set this property's value with <a href="qdatatable.html#setDateFormat">setDateFormat</a>() and get this property's value with <a href="qdatatable.html#dateFormat">dateFormat</a>().
  599. </doc>
  600. </property>
  601. <property>
  602.     <name>QDataTable::falseText</name>
  603.     <doc href="qdatatable.html#falseText-prop">  <p>This property holds the text used to represent false values.
  604. <p>The falseText property will be used to represent NULL values in the
  605. table. The default value is 'False'.
  606. <p> 
  607. <p>Set this property's value with <a href="qdatatable.html#setFalseText">setFalseText</a>() and get this property's value with <a href="qdatatable.html#falseText">falseText</a>().
  608. </doc>
  609. </property>
  610. <property>
  611.     <name>QDataTable::filter</name>
  612.     <doc href="qdatatable.html#filter-prop"> <p>This property holds the data filter for the data table.
  613. <p>The filter applies to the data shown in the table. To view data with
  614. a new filter, use <a href="qdatatable.html#refresh">refresh</a>(). A filter string is an SQL WHERE
  615. clause without the WHERE keyword.
  616. <p> There is no default filter.
  617. <p> <p>See also <a href="qdatatable.html#sort-prop">sort</a>.
  618.  
  619. <p> 
  620. <p>Set this property's value with <a href="qdatatable.html#setFilter">setFilter</a>() and get this property's value with <a href="qdatatable.html#filter">filter</a>().
  621. </doc>
  622. </property>
  623. <property>
  624.     <name>QDataTable::nullText</name>
  625.     <doc href="qdatatable.html#nullText-prop">  <p>This property holds the text used to represent NULL values.
  626. <p>The nullText property will be used to represent NULL values in the
  627. table. The default value is provided by the cursor's driver.
  628. <p> 
  629. <p>Set this property's value with <a href="qdatatable.html#setNullText">setNullText</a>() and get this property's value with <a href="qdatatable.html#nullText">nullText</a>().
  630. </doc>
  631. </property>
  632. <property>
  633.     <name>QDataTable::numCols</name>
  634.     <doc href="qdatatable.html#numCols-prop"> <p>This property holds the number of columns in the table.
  635. <p>
  636. <p>Get this property's value with <a href="qdatatable.html#numCols">numCols</a>().
  637. </doc>
  638. </property>
  639. <property>
  640.     <name>QDataTable::numRows</name>
  641.     <doc href="qdatatable.html#numRows-prop"> <p>This property holds the number of rows in the table.
  642. <p>
  643. <p>Get this property's value with <a href="qdatatable.html#numRows">numRows</a>().
  644. </doc>
  645. </property>
  646. <property>
  647.     <name>QDataTable::sort</name>
  648.     <doc href="qdatatable.html#sort-prop"> <p>This property holds the data table's sort.
  649. <p>The table's sort affects the order in which data records are displayed
  650. in the table.  To apply a sort, use <a href="qdatatable.html#refresh">refresh</a>().
  651. <p> When examining the sort property, a string list is returned with each
  652. item having the form 'fieldname order' (e.g., 'id ASC', 'surname DESC').
  653. <p> There is no default sort.
  654. <p> Note that if you want to iterate over the sort list, you should
  655. iterate over a copy, e.g.
  656. <pre>
  657.     <a href="qstringlist.html">QStringList</a> list = myDataTable.sort();
  658.     QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>();
  659.     while( it != list.<a href="qvaluelist.html#end">end</a>() ) {
  660.         myProcessing( *it );
  661.         ++it;
  662.     }
  663.     </pre>
  664.  
  665. <p> <p>See also <a href="qdatatable.html#filter-prop">filter</a> and <a href="qdatatable.html#refresh">refresh</a>().
  666.  
  667. <p> 
  668. <p>Set this property's value with <a href="qdatatable.html#setSort">setSort</a>() and get this property's value with <a href="qdatatable.html#sort">sort</a>().
  669. </doc>
  670. </property>
  671. <property>
  672.     <name>QDataTable::trueText</name>
  673.     <doc href="qdatatable.html#trueText-prop">  <p>This property holds the text used to represent true values.
  674. <p>The trueText property will be used to represent NULL values in the
  675. table. The default value is 'True'.
  676. <p> 
  677. <p>Set this property's value with <a href="qdatatable.html#setTrueText">setTrueText</a>() and get this property's value with <a href="qdatatable.html#trueText">trueText</a>().
  678. </doc>
  679. </property>
  680. <property>
  681.     <name>QDateEdit::autoAdvance</name>
  682.     <doc href="qdateedit.html#autoAdvance-prop"> <p>This property holds whether the editor automatically advances to the next section.
  683. <p>If autoAdvance is TRUE, the editor will automatically advance focus
  684. to the next date section if a user has completed a section. The
  685. default is FALSE.
  686. <p> 
  687. <p>Set this property's value with <a href="qdateedit.html#setAutoAdvance">setAutoAdvance</a>() and get this property's value with <a href="qdateedit.html#autoAdvance">autoAdvance</a>().
  688. </doc>
  689. </property>
  690. <property>
  691.     <name>QDateEdit::date</name>
  692.     <doc href="qdateedit.html#date-prop"> <p>This property holds the date value of the editor.
  693. <p>If the date property is not valid, the editor displays all zeroes
  694. and <a href="qdateedit.html#date">QDateEdit::date</a>() will return an invalid date.  It is strongly
  695. recommended that the editor be given a default date value.  That
  696. way, attempts to set the date property to an invalid date will fail.
  697. <p> When changing the date property, if the date is less than <a href="qdateedit.html#minValue">minValue</a>(),
  698. or is greater than <a href="qdateedit.html#maxValue">maxValue</a>(), nothing happens.
  699. <p> 
  700. <p>Set this property's value with <a href="qdateedit.html#setDate">setDate</a>() and get this property's value with <a href="qdateedit.html#date">date</a>().
  701. </doc>
  702. </property>
  703. <property>
  704.     <name>QDateEdit::maxValue</name>
  705.     <doc href="qdateedit.html#maxValue-prop"> <p>This property holds the maximum editor value.
  706. <p>Setting the maximum date value for the editor is equivalent to
  707. calling <a href="qdateedit.html#setRange">QDateEdit::setRange</a>( <a href="qdateedit.html#minValue">minValue</a>(), <em>d</em> ), where <em>d</em> is the
  708. maximum date. The default maximum date is 8000-12-31.
  709.  
  710. <p>Set this property's value with <a href="qdateedit.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qdateedit.html#maxValue">maxValue</a>().
  711. </doc>
  712. </property>
  713. <property>
  714.     <name>QDateEdit::minValue</name>
  715.     <doc href="qdateedit.html#minValue-prop"> <p>This property holds the minimum editor value.
  716. <p>Setting the minimum date value is equivalent to calling
  717. <a href="qdateedit.html#setRange">QDateEdit::setRange</a>( <em>d</em>, <a href="qdateedit.html#maxValue">maxValue</a>() ), where <em>d</em> is the
  718. minimum date. The default minimum date is 1752-09-14.
  719.  
  720. <p>Set this property's value with <a href="qdateedit.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qdateedit.html#minValue">minValue</a>().
  721. </doc>
  722. </property>
  723. <property>
  724.     <name>QDateEdit::order</name>
  725.     <doc href="qdateedit.html#order-prop"> <p>This property holds the order in which the year, month and day appear.
  726. <p>The default order is locale dependent.
  727. <p> <p>See also <a href="qdateedit.html#Order-enum">Order</a>.
  728.  
  729. <p>Set this property's value with <a href="qdateedit.html#setOrder">setOrder</a>() and get this property's value with <a href="qdateedit.html#order">order</a>().
  730. </doc>
  731. </property>
  732. <property>
  733.     <name>QDateTimeEdit::dateTime</name>
  734.     <doc href="qdatetimeedit.html#dateTime-prop"> <p>This property holds the datetime value of the editor.
  735. <p>The datetime edit's datetime which may be an invalid
  736. datetime.
  737.  
  738. <p>Set this property's value with <a href="qdatetimeedit.html#setDateTime">setDateTime</a>() and get this property's value with <a href="qdatetimeedit.html#dateTime">dateTime</a>().
  739. </doc>
  740. </property>
  741. <property>
  742.     <name>QDial::lineStep</name>
  743.     <doc href="qdial.html#lineStep-prop">
  744. <p>This property holds the current line step.
  745. <p>setLineStep() calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function if the new line
  746. step is different from the previous setting.
  747. <p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="qdial.html#pageStep-prop">pageStep</a> and <a href="qrangecontrol.html#setRange">setRange</a>().
  748.  
  749. <p>Set this property's value with <a href="qdial.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qdial.html#lineStep">lineStep</a>().
  750. </doc>
  751. </property>
  752. <property>
  753.     <name>QDial::maxValue</name>
  754.     <doc href="qdial.html#maxValue-prop">
  755. <p>This property holds the current maximum value.
  756. <p>When setting this property, the <a href="qdial.html#minValue-prop">QDial::minValue</a> is adjusted so that the
  757. range remains valid if necessary.
  758. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
  759.  
  760. <p>Set this property's value with <a href="qdial.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qdial.html#maxValue">maxValue</a>().
  761. </doc>
  762. </property>
  763. <property>
  764.     <name>QDial::minValue</name>
  765.     <doc href="qdial.html#minValue-prop">
  766. <p>This property holds the current minimum value.
  767. <p>When setting this property, the <a href="qdial.html#maxValue-prop">QDial::maxValue</a> is adjusted so that the
  768. range remains valid if necessary.
  769. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
  770.  
  771. <p>Set this property's value with <a href="qdial.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qdial.html#minValue">minValue</a>().
  772. </doc>
  773. </property>
  774. <property>
  775.     <name>QDial::notchSize</name>
  776.     <doc href="qdial.html#notchSize-prop">
  777. <p>This property holds the current notch size.
  778. <p>The notch size is in range control units, not pixels, and if possible it
  779. is a multiple of <a href="qdial.html#lineStep">lineStep</a>() that results in an on-screen notch size near
  780. <a href="qdial.html#notchTarget">notchTarget</a>().
  781. <p> <p>See also <a href="qdial.html#notchTarget-prop">notchTarget</a> and <a href="qdial.html#lineStep-prop">lineStep</a>.
  782.  
  783. <p>Get this property's value with <a href="qdial.html#notchSize">notchSize</a>().
  784. </doc>
  785. </property>
  786. <property>
  787.     <name>QDial::notchTarget</name>
  788.     <doc href="qdial.html#notchTarget-prop">
  789. <p>This property holds the target number of pixels between notches.
  790. <p>The notch target is the number of pixels QDial attempts to put between
  791. each notch.
  792. <p> The actual size may differ from the target size.
  793.  
  794. <p>Set this property's value with <a href="qdial.html#setNotchTarget">setNotchTarget</a>() and get this property's value with <a href="qdial.html#notchTarget">notchTarget</a>().
  795. </doc>
  796. </property>
  797. <property>
  798.     <name>QDial::notchesVisible</name>
  799.     <doc href="qdial.html#notchesVisible-prop">
  800. <p>This property holds whether the notches are shown.
  801. <p>If TRUE, the notches are shown. If FALSE (the default) notches are
  802. not shown.
  803.  
  804. <p>Set this property's value with <a href="qdial.html#setNotchesVisible">setNotchesVisible</a>() and get this property's value with <a href="qdial.html#notchesVisible">notchesVisible</a>().
  805. </doc>
  806. </property>
  807. <property>
  808.     <name>QDial::pageStep</name>
  809.     <doc href="qdial.html#pageStep-prop">
  810. <p>This property holds the current page step.
  811. <p>setPageStep() calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function if the new page
  812. step is different from the previous setting.
  813. <p> <p>See also <a href="qrangecontrol.html#stepChange">stepChange</a>().
  814.  
  815. <p>Set this property's value with <a href="qdial.html#setPageStep">setPageStep</a>() and get this property's value with <a href="qdial.html#pageStep">pageStep</a>().
  816. </doc>
  817. </property>
  818. <property>
  819.     <name>QDial::tracking</name>
  820.     <doc href="qdial.html#tracking-prop">
  821. <p>This property holds whether tracking is enabled.
  822. <p>If TRUE (the default), tracking is enabled. This means that the arrow
  823. can be moved using the mouse; otherwise the arrow cannot be moved with
  824. the mouse.
  825.  
  826. <p>Set this property's value with <a href="qdial.html#setTracking">setTracking</a>() and get this property's value with <a href="qdial.html#tracking">tracking</a>().
  827. </doc>
  828. </property>
  829. <property>
  830.     <name>QDial::value</name>
  831.     <doc href="qdial.html#value-prop">
  832. <p>This property holds the current dial value.
  833. <p>This is guaranteed to be within the range
  834. <a href="qdial.html#minValue-prop">QDial::minValue</a>..<a href="qdial.html#maxValue-prop">QDial::maxValue</a>.
  835. <p> <p>See also <a href="qdial.html#minValue-prop">minValue</a> and <a href="qdial.html#maxValue-prop">maxValue</a>.
  836.  
  837. <p>Set this property's value with <a href="qdial.html#setValue">setValue</a>() and get this property's value with <a href="qdial.html#value">value</a>().
  838. </doc>
  839. </property>
  840. <property>
  841.     <name>QDial::wrapping</name>
  842.     <doc href="qdial.html#wrapping-prop">
  843. <p>This property holds whether wrapping is enabled.
  844. <p>If TRUE, wrapping is enabled. This means that the arrow can be turned
  845. around 360░. Otherwise there is some space at the bottom of the dial
  846. which is skipped by the arrow.
  847. <p> This property's default is FALSE.
  848.  
  849. <p>Set this property's value with <a href="qdial.html#setWrapping">setWrapping</a>() and get this property's value with <a href="qdial.html#wrapping">wrapping</a>().
  850. </doc>
  851. </property>
  852. <property>
  853.     <name>QDialog::sizeGripEnabled</name>
  854.     <doc href="qdialog.html#sizeGripEnabled-prop">
  855. <p>This property holds whether the size grip is enabled.
  856. <p>A <a href="qsizegrip.html">QSizeGrip</a> is placed in the bottom right corner of the dialog when this
  857. property is enabled.  By default, the size grip is disabled.
  858.  
  859. <p>Set this property's value with <a href="qdialog.html#setSizeGripEnabled">setSizeGripEnabled</a>() and get this property's value with <a href="qdialog.html#isSizeGripEnabled">isSizeGripEnabled</a>().
  860. </doc>
  861. </property>
  862. <property>
  863.     <name>QDockArea::count</name>
  864.     <doc href="qdockarea.html#count-prop"> <p>This property holds the number of dock windows in the dock area.
  865. <p>
  866. <p>Get this property's value with <a href="qdockarea.html#count">count</a>().
  867. </doc>
  868. </property>
  869. <property>
  870.     <name>QDockArea::empty</name>
  871.     <doc href="qdockarea.html#empty-prop"> <p>This property holds whether the dock area is empty.
  872. <p>
  873. <p>Get this property's value with <a href="qdockarea.html#isEmpty">isEmpty</a>().
  874. </doc>
  875. </property>
  876. <property>
  877.     <name>QDockArea::handlePosition</name>
  878.     <doc href="qdockarea.html#handlePosition-prop"> <p>This property holds where the dock window splitter handle is placed in the dock area.
  879. <p>The default position is <a href="qdockarea.html#HandlePosition-enum">Normal</a>.
  880.  
  881. <p>Get this property's value with <a href="qdockarea.html#handlePosition">handlePosition</a>().
  882. </doc>
  883. </property>
  884. <property>
  885.     <name>QDockArea::orientation</name>
  886.     <doc href="qdockarea.html#orientation-prop"> <p>This property holds the dock area's orientation.
  887. <p>There is no default value; the orientation is specified in the constructor.
  888.  
  889. <p>Get this property's value with <a href="qdockarea.html#orientation">orientation</a>().
  890. </doc>
  891. </property>
  892. <property>
  893.     <name>QDockWindow::closeMode</name>
  894.     <doc href="qdockwindow.html#closeMode-prop"> <p>This property holds the close mode of a dock window.
  895. <p>Defines when (if ever) the dock window has a close button. The
  896. choices are <a href="qdockwindow.html#CloseMode-enum">Never</a>, <a href="qdockwindow.html#CloseMode-enum">Docked</a> (i.e. only when docked), <a href="qdockwindow.html#CloseMode-enum">Undocked</a>
  897. (only when undocked, i.e. floated) or <a href="qdockwindow.html#CloseMode-enum">Always</a>.
  898. <p> The default is <a href="qdockwindow.html#CloseMode-enum">Never</a>.
  899.  
  900. <p>Set this property's value with <a href="qdockwindow.html#setCloseMode">setCloseMode</a>() and get this property's value with <a href="qdockwindow.html#closeMode">closeMode</a>().
  901. </doc>
  902. </property>
  903. <property>
  904.     <name>QDockWindow::horizontallyStretchable</name>
  905.     <doc href="qdockwindow.html#horizontallyStretchable-prop"> <p>This property holds whether the dock window is horizontally stretchable.
  906. <p>A dock window is horizontally stretchable if you call
  907. <a href="qdockwindow.html#setHorizontallyStretchable">setHorizontallyStretchable</a>(TRUE) or <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(TRUE).
  908. <p> <p>See also <a href="qdockwindow.html#resizeEnabled-prop">resizeEnabled</a>.
  909.  
  910. <p>Set this property's value with <a href="qdockwindow.html#setHorizontallyStretchable">setHorizontallyStretchable</a>() and get this property's value with <a href="qdockwindow.html#isHorizontallyStretchable">isHorizontallyStretchable</a>().
  911. </doc>
  912. </property>
  913. <property>
  914.     <name>QDockWindow::movingEnabled</name>
  915.     <doc href="qdockwindow.html#movingEnabled-prop"> <p>This property holds whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window.
  916. <p>This property is TRUE by default.
  917.  
  918. <p>Set this property's value with <a href="qdockwindow.html#setMovingEnabled">setMovingEnabled</a>() and get this property's value with <a href="qdockwindow.html#isMovingEnabled">isMovingEnabled</a>().
  919. </doc>
  920. </property>
  921. <property>
  922.     <name>QDockWindow::newLine</name>
  923.     <doc href="qdockwindow.html#newLine-prop"> <p>This property holds whether the dock window prefers to start a new line in the dock area.
  924. <p>The default is FALSE, i.e. the dock window doesn't require a new
  925. line in the dock area.
  926.  
  927. <p>Set this property's value with <a href="qdockwindow.html#setNewLine">setNewLine</a>() and get this property's value with <a href="qdockwindow.html#newLine">newLine</a>().
  928. </doc>
  929. </property>
  930. <property>
  931.     <name>QDockWindow::offset</name>
  932.     <doc href="qdockwindow.html#offset-prop"> <p>This property holds the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas).
  933. <p>The default is 0.
  934.  
  935. <p>Set this property's value with <a href="qdockwindow.html#setOffset">setOffset</a>() and get this property's value with <a href="qdockwindow.html#offset">offset</a>().
  936. </doc>
  937. </property>
  938. <property>
  939.     <name>QDockWindow::opaqueMoving</name>
  940.     <doc href="qdockwindow.html#opaqueMoving-prop"> <p>This property holds whether the dock window will be shown normally whilst it is being moved.
  941. <p>If this property is FALSE, (the default), the dock window
  942. will be represented by an outline rectangle whilst it is being moved.
  943. <p> Opaque moving of toolbars and dockwindows is known to have several
  944. problems. We suggest not to use it at this point in time. We will
  945. fix that behavior problems in a future release.
  946.  
  947. <p>Set this property's value with <a href="qdockwindow.html#setOpaqueMoving">setOpaqueMoving</a>() and get this property's value with <a href="qdockwindow.html#opaqueMoving">opaqueMoving</a>().
  948. </doc>
  949. </property>
  950. <property>
  951.     <name>QDockWindow::place</name>
  952.     <doc href="qdockwindow.html#place-prop"> <p>This property holds whether the dock window is in a dock area.
  953. <p>The <a href="qdockwindow.html#place">place</a>() function returns the current place of the dock window.
  954. This is either <a href="qdockwindow.html#Place-enum">InDock</a> or <a href="qdockwindow.html#Place-enum">OutsideDock</a>.
  955. <p> <p>See also <a href="qdockarea.html#moveDockWindow">QDockArea::moveDockWindow</a>(), <a href="qdockarea.html#removeDockWindow">QDockArea::removeDockWindow</a>(), <a href="qmainwindow.html#moveDockWindow">QMainWindow::moveDockWindow</a>() and <a href="qmainwindow.html#removeDockWindow">QMainWindow::removeDockWindow</a>().
  956.  
  957. <p>Get this property's value with <a href="qdockwindow.html#place">place</a>().
  958. </doc>
  959. </property>
  960. <property>
  961.     <name>QDockWindow::resizeEnabled</name>
  962.     <doc href="qdockwindow.html#resizeEnabled-prop"> <p>This property holds whether the dock window is resizeable.
  963. <p>A resizeable dock window can be resized using splitter-like handles
  964. inside a dock area and like every other top level window when
  965. floating.
  966. <p> A dock window is both horizontally and vertically stretchable if you call
  967. or <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(TRUE).
  968. <p> This property is FALSE by default.
  969. <p> <p>See also <a href="qdockwindow.html#verticallyStretchable-prop">verticallyStretchable</a> and <a href="qdockwindow.html#horizontallyStretchable-prop">horizontallyStretchable</a>.
  970.  
  971. <p>Set this property's value with <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>() and get this property's value with <a href="qdockwindow.html#isResizeEnabled">isResizeEnabled</a>().
  972. </doc>
  973. </property>
  974. <property>
  975.     <name>QDockWindow::stretchable</name>
  976.     <doc href="qdockwindow.html#stretchable-prop"> <p>This property holds whether the dock window is stretchable in the current <a href="qdockwindow.html#orientation">orientation</a>().
  977. <p>This property can be set using <a href="qdockwindow.html#setHorizontallyStretchable">setHorizontallyStretchable</a>() and
  978. <a href="qdockwindow.html#setVerticallyStretchable">setVerticallyStretchable</a>(), or with <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>().
  979. <p>See also <a href="qdockwindow.html#resizeEnabled-prop">resizeEnabled</a>.
  980.  
  981. <p>Get this property's value with <a href="qdockwindow.html#isStretchable">isStretchable</a>().
  982. </doc>
  983. </property>
  984. <property>
  985.     <name>QDockWindow::verticallyStretchable</name>
  986.     <doc href="qdockwindow.html#verticallyStretchable-prop"> <p>This property holds whether the dock window is vertically stretchable.
  987. <p>A dock window is horizontally stretchable if you call
  988. <a href="qdockwindow.html#setVerticallyStretchable">setVerticallyStretchable</a>(TRUE) or <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(TRUE).
  989. <p>See also <a href="qdockwindow.html#resizeEnabled-prop">resizeEnabled</a>.
  990.  
  991. <p>Set this property's value with <a href="qdockwindow.html#setVerticallyStretchable">setVerticallyStretchable</a>() and get this property's value with <a href="qdockwindow.html#isVerticallyStretchable">isVerticallyStretchable</a>().
  992. </doc>
  993. </property>
  994. <property>
  995.     <name>QDoubleValidator::bottom</name>
  996.     <doc href="qdoublevalidator.html#bottom-prop"> <p>This property holds the validator's minimum acceptable value.
  997. <p>Set this property's value with <a href="qdoublevalidator.html#setBottom">setBottom</a>() and get this property's value with <a href="qdoublevalidator.html#bottom">bottom</a>().
  998. <p><p>See also <a href="qdoublevalidator.html#setRange">setRange</a>().
  999.  
  1000. </doc>
  1001. </property>
  1002. <property>
  1003.     <name>QDoubleValidator::decimals</name>
  1004.     <doc href="qdoublevalidator.html#decimals-prop"> <p>This property holds the validator's maximum number of digits after the decimal point.
  1005. <p>Set this property's value with <a href="qdoublevalidator.html#setDecimals">setDecimals</a>() and get this property's value with <a href="qdoublevalidator.html#decimals">decimals</a>().
  1006. <p><p>See also <a href="qdoublevalidator.html#setRange">setRange</a>().
  1007.  
  1008. </doc>
  1009. </property>
  1010. <property>
  1011.     <name>QDoubleValidator::top</name>
  1012.     <doc href="qdoublevalidator.html#top-prop"> <p>This property holds the validator's maximum acceptable value.
  1013. <p>Set this property's value with <a href="qdoublevalidator.html#setTop">setTop</a>() and get this property's value with <a href="qdoublevalidator.html#top">top</a>().
  1014. <p><p>See also <a href="qdoublevalidator.html#setRange">setRange</a>().
  1015.  
  1016. </doc>
  1017. </property>
  1018. <property>
  1019.     <name>QFileDialog::contentsPreview</name>
  1020.     <doc href="qfiledialog.html#contentsPreview-prop">
  1021. <p>This property holds whether the file dialog offers the possibility of previewing the contents of the currently selected file.
  1022. <p>The default is FALSE.
  1023. <p> <p>See also <a href="qfiledialog.html#setContentsPreview">setContentsPreview</a>() and <a href="qfiledialog.html#infoPreview-prop">infoPreview</a>.
  1024.  
  1025. <p>Set this property's value with <a href="qfiledialog.html#setContentsPreviewEnabled">setContentsPreviewEnabled</a>() and get this property's value with <a href="qfiledialog.html#isContentsPreviewEnabled">isContentsPreviewEnabled</a>().
  1026. </doc>
  1027. </property>
  1028. <property>
  1029.     <name>QFileDialog::dirPath</name>
  1030.     <doc href="qfiledialog.html#dirPath-prop">
  1031. <p>This property holds the file dialog's working directory.
  1032. <p>Get this property's value with <a href="qfiledialog.html#dirPath">dirPath</a>().
  1033. <p><p>See also <a href="qfiledialog.html#dir">dir</a>() and <a href="qfiledialog.html#setDir">setDir</a>().
  1034.  
  1035. </doc>
  1036. </property>
  1037. <property>
  1038.     <name>QFileDialog::infoPreview</name>
  1039.     <doc href="qfiledialog.html#infoPreview-prop">
  1040. <p>This property holds whether the file dialog offers the possibility to preview information about the currently selected file.
  1041. <p>The default is FALSE.
  1042.  
  1043. <p>Set this property's value with <a href="qfiledialog.html#setInfoPreviewEnabled">setInfoPreviewEnabled</a>() and get this property's value with <a href="qfiledialog.html#isInfoPreviewEnabled">isInfoPreviewEnabled</a>().
  1044. </doc>
  1045. </property>
  1046. <property>
  1047.     <name>QFileDialog::mode</name>
  1048.     <doc href="qfiledialog.html#mode-prop">
  1049. <p>This property holds the file dialog's mode.
  1050. <p>The default mode is <a href="qfiledialog.html#Mode-enum">ExistingFile</a>.
  1051.  
  1052. <p>Set this property's value with <a href="qfiledialog.html#setMode">setMode</a>() and get this property's value with <a href="qfiledialog.html#mode">mode</a>().
  1053. </doc>
  1054. </property>
  1055. <property>
  1056.     <name>QFileDialog::previewMode</name>
  1057.     <doc href="qfiledialog.html#previewMode-prop">
  1058. <p>This property holds the preview mode for the file dialog.
  1059. <p>If you set the mode to be a mode other than <em>NoPreview</em>, then use
  1060. <a href="qfiledialog.html#setInfoPreview">setInfoPreview</a>() or <a href="qfiledialog.html#setContentsPreview">setContentsPreview</a>() to set the dialog's preview
  1061. widget to your preview widget and enable the preview widget(s) with
  1062. <a href="qfiledialog.html#setInfoPreviewEnabled">setInfoPreviewEnabled</a>() or <a href="qfiledialog.html#setContentsPreviewEnabled">setContentsPreviewEnabled</a>().
  1063. <p> <p>See also <a href="qfiledialog.html#infoPreview-prop">infoPreview</a>, <a href="qfiledialog.html#contentsPreview-prop">contentsPreview</a> and <a href="qfiledialog.html#viewMode-prop">viewMode</a>.
  1064.  
  1065. <p>Set this property's value with <a href="qfiledialog.html#setPreviewMode">setPreviewMode</a>() and get this property's value with <a href="qfiledialog.html#previewMode">previewMode</a>().
  1066. </doc>
  1067. </property>
  1068. <property>
  1069.     <name>QFileDialog::selectedFile</name>
  1070.     <doc href="qfiledialog.html#selectedFile-prop">
  1071. <p>This property holds the name of the selected file.
  1072. <p>If a file was selected selectedFile contains the file's name including
  1073. its absolute path; otherwise selectedFile is empty.
  1074. <p> <p>See also <a href="qstring.html#isEmpty">QString::isEmpty</a>(), <a href="qfiledialog.html#selectedFiles-prop">selectedFiles</a> and <a href="qfiledialog.html#selectedFilter-prop">selectedFilter</a>.
  1075.  
  1076. <p>Get this property's value with <a href="qfiledialog.html#selectedFile">selectedFile</a>().
  1077. </doc>
  1078. </property>
  1079. <property>
  1080.     <name>QFileDialog::selectedFiles</name>
  1081.     <doc href="qfiledialog.html#selectedFiles-prop">
  1082. <p>This property holds a list of selected files.
  1083. <p>If one or more files were selected selectedFiles contains the
  1084. names of the selected files including their absolute paths. If no
  1085. files were selected or the mode wasn't ExistingFiles selectedFiles
  1086. is an empty list.
  1087. <p> It is more convenient to use <a href="qfiledialog.html#selectedFile">selectedFile</a>() if the mode is
  1088. <a href="qfiledialog.html#Mode-enum">ExistingFile</a>, <a href="qfiledialog.html#Mode-enum">Directory</a> or <a href="qfiledialog.html#Mode-enum">DirectoryOnly</a>.
  1089. <p> Note that if you want to iterate over the list, you should
  1090. iterate over a copy, e.g.
  1091. <pre>
  1092.     <a href="qstringlist.html">QStringList</a> list = myFileDialog.selectedFiles();
  1093.     QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>();
  1094.     while( it != list.<a href="qvaluelist.html#end">end</a>() ) {
  1095.         myProcessing( *it );
  1096.         ++it;
  1097.     }
  1098.     </pre>
  1099.  
  1100. <p> <p>See also <a href="qfiledialog.html#selectedFile-prop">selectedFile</a>, <a href="qfiledialog.html#selectedFilter-prop">selectedFilter</a> and <a href="qvaluelist.html#empty">QValueList::empty</a>().
  1101.  
  1102. <p>Get this property's value with <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().
  1103. </doc>
  1104. </property>
  1105. <property>
  1106.     <name>QFileDialog::selectedFilter</name>
  1107.     <doc href="qfiledialog.html#selectedFilter-prop">
  1108. <p>This property holds the filter which the user has selected in the file dialog.
  1109. <p>Get this property's value with <a href="qfiledialog.html#selectedFilter">selectedFilter</a>().
  1110. <p><p>See also <a href="qfiledialog.html#filterSelected">filterSelected</a>(), <a href="qfiledialog.html#selectedFiles-prop">selectedFiles</a> and <a href="qfiledialog.html#selectedFile-prop">selectedFile</a>.
  1111.  
  1112. </doc>
  1113. </property>
  1114. <property>
  1115.     <name>QFileDialog::showHiddenFiles</name>
  1116.     <doc href="qfiledialog.html#showHiddenFiles-prop">
  1117. <p>This property holds whether hidden files are shown in the file dialog.
  1118. <p>The default is FALSE, i.e. don't show hidden files.
  1119.  
  1120. <p>Set this property's value with <a href="qfiledialog.html#setShowHiddenFiles">setShowHiddenFiles</a>() and get this property's value with <a href="qfiledialog.html#showHiddenFiles">showHiddenFiles</a>().
  1121. </doc>
  1122. </property>
  1123. <property>
  1124.     <name>QFileDialog::viewMode</name>
  1125.     <doc href="qfiledialog.html#viewMode-prop">
  1126. <p>This property holds the file dialog's view mode.
  1127. <p>If you set the view mode to be <em>Detail</em> (the default), then you
  1128. will see the file's details, such as the size of the file and the
  1129. date the file was last modified alongside the file.
  1130. <p> If you set the view mode to be <em>List</em>, then you will just
  1131. see a list of the files and folders.
  1132. <p> See <a href="qfiledialog.html#ViewMode-enum">QFileDialog::ViewMode</a>
  1133.  
  1134. <p>Set this property's value with <a href="qfiledialog.html#setViewMode">setViewMode</a>() and get this property's value with <a href="qfiledialog.html#viewMode">viewMode</a>().
  1135. </doc>
  1136. </property>
  1137. <property>
  1138.     <name>QFrame::contentsRect</name>
  1139.     <doc href="qframe.html#contentsRect-prop"> <p>This property holds the rectangle inside the frame.
  1140. <p>Get this property's value with <a href="qframe.html#contentsRect">contentsRect</a>().
  1141. <p><p>See also <a href="qframe.html#frameRect-prop">frameRect</a> and <a href="qframe.html#drawContents">drawContents</a>().
  1142.  
  1143. </doc>
  1144. </property>
  1145. <property>
  1146.     <name>QFrame::frameRect</name>
  1147.     <doc href="qframe.html#frameRect-prop"> <p>This property holds the frame rectangle.
  1148. <p>The frame rectangle is the rectangle the frame is drawn in.  By
  1149. default, this is the entire widget.  Setting this property does <em>not</em> cause a widget update.
  1150. <p> If this property is set to a null rectangle (for example
  1151. <tt>QRect(0, 0, 0, 0)</tt>), then the frame rectangle is equivalent
  1152. to the <a href="qwidget.html#rect">widget rectangle</a>.
  1153. <p> <p>See also <a href="qframe.html#contentsRect-prop">contentsRect</a>.
  1154.  
  1155. <p>Set this property's value with <a href="qframe.html#setFrameRect">setFrameRect</a>() and get this property's value with <a href="qframe.html#frameRect">frameRect</a>().
  1156. </doc>
  1157. </property>
  1158. <property>
  1159.     <name>QFrame::frameShadow</name>
  1160.     <doc href="qframe.html#frameShadow-prop"> <p>This property holds the frame shadow value from the frame style.
  1161. <p>Set this property's value with <a href="qframe.html#setFrameShadow">setFrameShadow</a>() and get this property's value with <a href="qframe.html#frameShadow">frameShadow</a>().
  1162. <p><p>See also <a href="qframe.html#frameStyle">frameStyle</a>() and <a href="qframe.html#frameShape-prop">frameShape</a>.
  1163.  
  1164. </doc>
  1165. </property>
  1166. <property>
  1167.     <name>QFrame::frameShape</name>
  1168.     <doc href="qframe.html#frameShape-prop"> <p>This property holds the frame shape value from the frame style.
  1169. <p>Set this property's value with <a href="qframe.html#setFrameShape">setFrameShape</a>() and get this property's value with <a href="qframe.html#frameShape">frameShape</a>().
  1170. <p><p>See also <a href="qframe.html#frameStyle">frameStyle</a>() and <a href="qframe.html#frameShadow-prop">frameShadow</a>.
  1171.  
  1172. </doc>
  1173. </property>
  1174. <property>
  1175.     <name>QFrame::frameWidth</name>
  1176.     <doc href="qframe.html#frameWidth-prop"> <p>This property holds the width of the frame that is drawn.
  1177. <p>Note that the frame width depends on the <a href="qframe.html#setFrameStyle">frame
  1178.   style</a>, not only the line width and the mid-line width.  For
  1179. example, the style <a href="qframe.html#Shape-enum">NoFrame</a> always has a frame width 0, whereas the
  1180. style <a href="qframe.html#Shape-enum">Panel</a> has a frame width equivalent to the line width.
  1181. The frame width also includes the margin.
  1182. <p> <p>See also <a href="qframe.html#lineWidth-prop">lineWidth</a>, <a href="qframe.html#midLineWidth-prop">midLineWidth</a>, <a href="qframe.html#frameStyle">frameStyle</a>() and <a href="qframe.html#margin-prop">margin</a>.
  1183.  
  1184. <p>Get this property's value with <a href="qframe.html#frameWidth">frameWidth</a>().
  1185. </doc>
  1186. </property>
  1187. <property>
  1188.     <name>QFrame::lineWidth</name>
  1189.     <doc href="qframe.html#lineWidth-prop"> <p>This property holds the line width.
  1190. <p>Note that the <em>total</em> line width for <a href="qframe.html#Shape-enum">HLine</a> and <a href="qframe.html#Shape-enum">VLine</a>
  1191. is given by <a href="qframe.html#frameWidth">frameWidth</a>(), not <a href="qframe.html#lineWidth">lineWidth</a>().
  1192. <p> The default value is 1.
  1193. <p> <p>See also <a href="qframe.html#midLineWidth-prop">midLineWidth</a> and <a href="qframe.html#frameWidth-prop">frameWidth</a>.
  1194.  
  1195. <p>Set this property's value with <a href="qframe.html#setLineWidth">setLineWidth</a>() and get this property's value with <a href="qframe.html#lineWidth">lineWidth</a>().
  1196. </doc>
  1197. </property>
  1198. <property>
  1199.     <name>QFrame::margin</name>
  1200.     <doc href="qframe.html#margin-prop"> <p>This property holds the width of the margin.
  1201. <p>The margin is the distance between the innermost pixel of the frame and
  1202. he outermost pixel of <a href="qframe.html#contentsRect">contentsRect</a>(). It is included in <a href="qframe.html#frameWidth">frameWidth</a>().
  1203. <p> The margin is filled according to <a href="qwidget.html#backgroundMode">backgroundMode</a>().
  1204. <p> The default value is 0.
  1205. <p> <p>See also <a href="qframe.html#margin-prop">margin</a>, <a href="qframe.html#lineWidth-prop">lineWidth</a> and <a href="qframe.html#frameWidth-prop">frameWidth</a>.
  1206.  
  1207. <p>Set this property's value with <a href="qframe.html#setMargin">setMargin</a>() and get this property's value with <a href="qframe.html#margin">margin</a>().
  1208. </doc>
  1209. </property>
  1210. <property>
  1211.     <name>QFrame::midLineWidth</name>
  1212.     <doc href="qframe.html#midLineWidth-prop"> <p>This property holds the width of the mid-line.
  1213. <p>The default value is 0.
  1214. <p> <p>See also <a href="qframe.html#lineWidth-prop">lineWidth</a> and <a href="qframe.html#frameWidth-prop">frameWidth</a>.
  1215.  
  1216. <p>Set this property's value with <a href="qframe.html#setMidLineWidth">setMidLineWidth</a>() and get this property's value with <a href="qframe.html#midLineWidth">midLineWidth</a>().
  1217. </doc>
  1218. </property>
  1219. <property>
  1220.     <name>QGridView::cellHeight</name>
  1221.     <doc href="qgridview.html#cellHeight-prop"> <p>This property holds the height of a grid row.
  1222. <p>All rows in a grid view have the same height.
  1223. <p> <p>See also <a href="qgridview.html#cellWidth-prop">cellWidth</a>.
  1224.  
  1225. <p>Set this property's value with <a href="qgridview.html#setCellHeight">setCellHeight</a>() and get this property's value with <a href="qgridview.html#cellHeight">cellHeight</a>().
  1226. </doc>
  1227. </property>
  1228. <property>
  1229.     <name>QGridView::cellWidth</name>
  1230.     <doc href="qgridview.html#cellWidth-prop"> <p>This property holds the width of a grid column.
  1231. <p>All columns in a grid view have the same width.
  1232. <p> <p>See also <a href="qgridview.html#cellHeight-prop">cellHeight</a>.
  1233.  
  1234. <p>Set this property's value with <a href="qgridview.html#setCellWidth">setCellWidth</a>() and get this property's value with <a href="qgridview.html#cellWidth">cellWidth</a>().
  1235. </doc>
  1236. </property>
  1237. <property>
  1238.     <name>QGridView::numCols</name>
  1239.     <doc href="qgridview.html#numCols-prop"> <p>This property holds the number of columns in the grid.
  1240. <p>Set this property's value with <a href="qgridview.html#setNumCols">setNumCols</a>() and get this property's value with <a href="qgridview.html#numCols">numCols</a>().
  1241. <p><p>See also <a href="qgridview.html#numRows-prop">numRows</a>.
  1242.  
  1243. </doc>
  1244. </property>
  1245. <property>
  1246.     <name>QGridView::numRows</name>
  1247.     <doc href="qgridview.html#numRows-prop"> <p>This property holds the number of rows in the grid.
  1248. <p>Set this property's value with <a href="qgridview.html#setNumRows">setNumRows</a>() and get this property's value with <a href="qgridview.html#numRows">numRows</a>().
  1249. <p><p>See also <a href="qgridview.html#numCols-prop">numCols</a>.
  1250.  
  1251. </doc>
  1252. </property>
  1253. <property>
  1254.     <name>QGroupBox::alignment</name>
  1255.     <doc href="qgroupbox.html#alignment-prop">
  1256. <p>This property holds the alignment of the group box title.
  1257. <p>The title is always placed on the upper frame line; however,
  1258. the horizontal alignment can be specified by the alignment parameter.
  1259. <p> The alignment is one of the following flags:
  1260. <ul>
  1261. <li> <a href="qt.html#AlignmentFlags-enum">AlignAuto</a> aligns the title accroding to the language, usually left.
  1262. <li> <a href="qt.html#AlignmentFlags-enum">AlignLeft</a> aligns the title text to the left.
  1263. <li> <a href="qt.html#AlignmentFlags-enum">AlignRight</a> aligns the title text to the right.
  1264. <li> <a href="qt.html#AlignmentFlags-enum">AlignHCenter</a> aligns the title text centered.
  1265. </ul>
  1266. <p> The default alignment is <a href="qt.html#AlignmentFlags-enum">AlignAuto</a>.
  1267. <p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>.
  1268.  
  1269. <p>Set this property's value with <a href="qgroupbox.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qgroupbox.html#alignment">alignment</a>().
  1270. </doc>
  1271. </property>
  1272. <property>
  1273.     <name>QGroupBox::columns</name>
  1274.     <doc href="qgroupbox.html#columns-prop">
  1275. <p>This property holds the number of columns or rows (depending on <a href="qgroupbox.html#orientation-prop">orientation</a>) in the group box.
  1276. <p>Usually it is not a good idea to set this property because it is slow
  1277. (it does a complete layout).  It is better to set the number of columns
  1278. directly in the constructor.
  1279.  
  1280. <p>Set this property's value with <a href="qgroupbox.html#setColumns">setColumns</a>() and get this property's value with <a href="qgroupbox.html#columns">columns</a>().
  1281. </doc>
  1282. </property>
  1283. <property>
  1284.     <name>QGroupBox::orientation</name>
  1285.     <doc href="qgroupbox.html#orientation-prop">
  1286. <p>This property holds the current orientation of the group box.
  1287. <p>A horizontal group box arranges it's children in columns, while a
  1288. vertical group box arranges them in rows. Thus, a horizontal group box
  1289. with only one column will arrange the children vertically in that column.
  1290. <p> Usually it is not a good idea to set this property because it is slow
  1291. (it does a complete layout). It is better to set the orientation directly
  1292. in the constructor.
  1293.  
  1294. <p>Set this property's value with <a href="qgroupbox.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qgroupbox.html#orientation">orientation</a>().
  1295. </doc>
  1296. </property>
  1297. <property>
  1298.     <name>QGroupBox::title</name>
  1299.     <doc href="qgroupbox.html#title-prop">
  1300. <p>This property holds the group box title text.
  1301. <p>The group box title text will have a focus-change keyboard
  1302. accelerator if the title contains &amp;, followed by a letter.
  1303. <p> <pre>
  1304.       g-&gt;setTitle( "&amp;User information" );
  1305.   </pre>
  1306.  
  1307. This produces "User information" with the U underlined;
  1308. Alt+U moves the keyboard focus to the group box.
  1309. <p> There is no default title text.
  1310. <p> 
  1311. <p>Set this property's value with <a href="qgroupbox.html#setTitle">setTitle</a>() and get this property's value with <a href="qgroupbox.html#title">title</a>().
  1312. </doc>
  1313. </property>
  1314. <property>
  1315.     <name>QHeader::count</name>
  1316.     <doc href="qheader.html#count-prop"> <p>This property holds the number of sections in the header.
  1317. <p>
  1318. <p>Get this property's value with <a href="qheader.html#count">count</a>().
  1319. </doc>
  1320. </property>
  1321. <property>
  1322.     <name>QHeader::moving</name>
  1323.     <doc href="qheader.html#moving-prop"> <p>This property holds whether the header sections can be moved.
  1324. <p>If this property is TRUE the user may move sections. If the user
  1325. moves a section the <a href="qheader.html#indexChange">indexChange</a>() signal is emitted.
  1326. <p> <p>See also <a href="qheader.html#setClickEnabled">setClickEnabled</a>() and <a href="qheader.html#setResizeEnabled">setResizeEnabled</a>().
  1327.  
  1328. <p>Set this property's value with <a href="qheader.html#setMovingEnabled">setMovingEnabled</a>() and get this property's value with <a href="qheader.html#isMovingEnabled">isMovingEnabled</a>().
  1329. </doc>
  1330. </property>
  1331. <property>
  1332.     <name>QHeader::offset</name>
  1333.     <doc href="qheader.html#offset-prop"> <p>This property holds the header's leftmost (or topmost) visible pixel.
  1334. <p>Setting this property will scroll the header so that <em>offset</em> becomes
  1335. the leftmost (or topmost for vertical headers) visible pixel.
  1336.  
  1337. <p>Set this property's value with <a href="qheader.html#setOffset">setOffset</a>() and get this property's value with <a href="qheader.html#offset">offset</a>().
  1338. </doc>
  1339. </property>
  1340. <property>
  1341.     <name>QHeader::orientation</name>
  1342.     <doc href="qheader.html#orientation-prop"> <p>This property holds the header's physical orientation.
  1343. <p>The orientation is either QHeader::Vertical or
  1344. QHeader::Horizontal (the default).
  1345. <p> Call <a href="qheader.html#setOrientation">setOrientation</a>() before adding labels if you don't provide a
  1346. size parameter otherwise the sizes will be incorrect.
  1347.  
  1348. <p>Set this property's value with <a href="qheader.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qheader.html#orientation">orientation</a>().
  1349. </doc>
  1350. </property>
  1351. <property>
  1352.     <name>QHeader::stretching</name>
  1353.     <doc href="qheader.html#stretching-prop"> <p>This property holds whether the header sections always take up the full width (or height) of the header.
  1354. <p>
  1355. <p>Set this property's value with <a href="qheader.html#setStretchEnabled">setStretchEnabled</a>() and get this property's value with <a href="qheader.html#isStretchEnabled">isStretchEnabled</a>().
  1356. </doc>
  1357. </property>
  1358. <property>
  1359.     <name>QHeader::tracking</name>
  1360.     <doc href="qheader.html#tracking-prop"> <p>This property holds whether the <a href="qheader.html#sizeChange">sizeChange</a>() signal is emitted continuously.
  1361. <p>If tracking is on, the sizeChange() signal is emitted continuously
  1362. while the mouse is moved (i.e. when the header is resized), otherwise
  1363. it is only emitted when the mouse button is released at the end of
  1364. resizing.
  1365. <p> Tracking defaults to FALSE.
  1366.  
  1367. <p>Set this property's value with <a href="qheader.html#setTracking">setTracking</a>() and get this property's value with <a href="qheader.html#tracking">tracking</a>().
  1368. </doc>
  1369. </property>
  1370. <property>
  1371.     <name>QIconView::arrangement</name>
  1372.     <doc href="qiconview.html#arrangement-prop"> <p>This property holds the arrangement mode of the icon view.
  1373. <p>This can be <a href="qiconview.html#Arrangement-enum">LeftToRight</a> or <a href="qiconview.html#Arrangement-enum">TopToBottom</a>. The default is <a href="qiconview.html#Arrangement-enum">LeftToRight</a>.
  1374.  
  1375. <p>Set this property's value with <a href="qiconview.html#setArrangement">setArrangement</a>() and get this property's value with <a href="qiconview.html#arrangement">arrangement</a>().
  1376. </doc>
  1377. </property>
  1378. <property>
  1379.     <name>QIconView::autoArrange</name>
  1380.     <doc href="qiconview.html#autoArrange-prop"> <p>This property holds whether the icon view rearranges its items when a new item is inserted.
  1381. <p>The default is set to TRUE.
  1382. <p> Note that if the icon view is not visible at the time of insertion,
  1383. QIconView defers all position-related work until it's shown and then
  1384. calls <a href="qiconview.html#arrangeItemsInGrid">arrangeItemsInGrid</a>().
  1385.  
  1386. <p>Set this property's value with <a href="qiconview.html#setAutoArrange">setAutoArrange</a>() and get this property's value with <a href="qiconview.html#autoArrange">autoArrange</a>().
  1387. </doc>
  1388. </property>
  1389. <property>
  1390.     <name>QIconView::count</name>
  1391.     <doc href="qiconview.html#count-prop"> <p>This property holds the number of items in the icon view.
  1392. <p>
  1393. <p>Get this property's value with <a href="qiconview.html#count">count</a>().
  1394. </doc>
  1395. </property>
  1396. <property>
  1397.     <name>QIconView::gridX</name>
  1398.     <doc href="qiconview.html#gridX-prop">  <p>This property holds the horizontal grid of the icon view.
  1399. <p>If the value is -1, (the default), QIconView computes suitable
  1400. column widths based on the icon view's contents.
  1401. <p> Note that setting a grid width overrides <a href="qiconview.html#setMaxItemWidth">setMaxItemWidth</a>().
  1402.  
  1403. <p>Set this property's value with <a href="qiconview.html#setGridX">setGridX</a>() and get this property's value with <a href="qiconview.html#gridX">gridX</a>().
  1404. </doc>
  1405. </property>
  1406. <property>
  1407.     <name>QIconView::gridY</name>
  1408.     <doc href="qiconview.html#gridY-prop">  <p>This property holds the vertical grid of the icon view.
  1409. <p>If the value is -1, (the default), QIconView computes suitable
  1410. column heights based on the icon view's contents.
  1411.  
  1412. <p>Set this property's value with <a href="qiconview.html#setGridY">setGridY</a>() and get this property's value with <a href="qiconview.html#gridY">gridY</a>().
  1413. </doc>
  1414. </property>
  1415. <property>
  1416.     <name>QIconView::itemTextBackground</name>
  1417.     <doc href="qiconview.html#itemTextBackground-prop"> <p>This property holds the brush that should be used when drawing the background of an item's text.
  1418. <p>By default this brush is set to NoBrush, meaning that only the
  1419. normal icon view background is used.
  1420.  
  1421. <p>Set this property's value with <a href="qiconview.html#setItemTextBackground">setItemTextBackground</a>() and get this property's value with <a href="qiconview.html#itemTextBackground">itemTextBackground</a>().
  1422. </doc>
  1423. </property>
  1424. <property>
  1425.     <name>QIconView::itemTextPos</name>
  1426.     <doc href="qiconview.html#itemTextPos-prop"> <p>This property holds the position where the text of each item is drawn.
  1427. <p>Valid values are <a href="qiconview.html#ItemTextPos-enum">Bottom</a> or <a href="qiconview.html#ItemTextPos-enum">Right</a>. The default is <a href="qiconview.html#ItemTextPos-enum">Bottom</a>.
  1428.  
  1429. <p>Set this property's value with <a href="qiconview.html#setItemTextPos">setItemTextPos</a>() and get this property's value with <a href="qiconview.html#itemTextPos">itemTextPos</a>().
  1430. </doc>
  1431. </property>
  1432. <property>
  1433.     <name>QIconView::itemsMovable</name>
  1434.     <doc href="qiconview.html#itemsMovable-prop"> <p>This property holds whether the user is allowed to move items around in the icon view.
  1435. <p>The default is TRUE.
  1436.  
  1437. <p>Set this property's value with <a href="qiconview.html#setItemsMovable">setItemsMovable</a>() and get this property's value with <a href="qiconview.html#itemsMovable">itemsMovable</a>().
  1438. </doc>
  1439. </property>
  1440. <property>
  1441.     <name>QIconView::maxItemTextLength</name>
  1442.     <doc href="qiconview.html#maxItemTextLength-prop">  <p>This property holds the maximum length (in characters) that an item's text may have.
  1443. <p>The default is 255 characters.
  1444.  
  1445. <p>Set this property's value with <a href="qiconview.html#setMaxItemTextLength">setMaxItemTextLength</a>() and get this property's value with <a href="qiconview.html#maxItemTextLength">maxItemTextLength</a>().
  1446. </doc>
  1447. </property>
  1448. <property>
  1449.     <name>QIconView::maxItemWidth</name>
  1450.     <doc href="qiconview.html#maxItemWidth-prop"> <p>This property holds the maximum width that an item may have.
  1451. <p>The default is 100 pixels.
  1452. <p> Note that if the <a href="qiconview.html#gridX">gridX</a>() value is set QIconView will ignore
  1453. this property.
  1454.  
  1455. <p>Set this property's value with <a href="qiconview.html#setMaxItemWidth">setMaxItemWidth</a>() and get this property's value with <a href="qiconview.html#maxItemWidth">maxItemWidth</a>().
  1456. </doc>
  1457. </property>
  1458. <property>
  1459.     <name>QIconView::resizeMode</name>
  1460.     <doc href="qiconview.html#resizeMode-prop"> <p>This property holds the resize mode of the icon view.
  1461. <p>This can be <a href="qiconview.html#ResizeMode-enum">Fixed</a> or <a href="qiconview.html#ResizeMode-enum">Adjust</a>. The default is <a href="qiconview.html#ResizeMode-enum">Fixed</a>.
  1462.  
  1463. <p>Set this property's value with <a href="qiconview.html#setResizeMode">setResizeMode</a>() and get this property's value with <a href="qiconview.html#resizeMode">resizeMode</a>().
  1464. </doc>
  1465. </property>
  1466. <property>
  1467.     <name>QIconView::selectionMode</name>
  1468.     <doc href="qiconview.html#selectionMode-prop"> <p>This property holds the selection mode of the icon view.
  1469. <p>This can be <a href="qiconview.html#SelectionMode-enum">Single</a> (the default), <a href="qiconview.html#SelectionMode-enum">Extended</a>, <a href="qiconview.html#SelectionMode-enum">Multi</a> or <a href="qiconview.html#SelectionMode-enum">NoSelection</a>.
  1470.  
  1471. <p>Set this property's value with <a href="qiconview.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qiconview.html#selectionMode">selectionMode</a>().
  1472. </doc>
  1473. </property>
  1474. <property>
  1475.     <name>QIconView::showToolTips</name>
  1476.     <doc href="qiconview.html#showToolTips-prop"> <p>This property holds whether the icon view will display a tool tip with the complete text for any truncated item text.
  1477. <p>The default is TRUE. Note that this has no effect if
  1478. <a href="qiconview.html#setWordWrapIconText">setWordWrapIconText</a>() is TRUE, as it is by default.
  1479.  
  1480. <p>Set this property's value with <a href="qiconview.html#setShowToolTips">setShowToolTips</a>() and get this property's value with <a href="qiconview.html#showToolTips">showToolTips</a>().
  1481. </doc>
  1482. </property>
  1483. <property>
  1484.     <name>QIconView::sortDirection</name>
  1485.     <doc href="qiconview.html#sortDirection-prop"> <p>This property holds whether the sort direction for inserting new items is ascending;.
  1486. <p>The default is TRUE (i.e. ascending). This sort direction only has
  1487. meaning if <a href="qiconview.html#sorting">sorting</a>() and <a href="qiconview.html#autoArrange">autoArrange</a>() are both TRUE.
  1488. <p> To set the sort direction, use <a href="qiconview.html#setSorting">setSorting</a>()
  1489.  
  1490. <p>Get this property's value with <a href="qiconview.html#sortDirection">sortDirection</a>().
  1491. </doc>
  1492. </property>
  1493. <property>
  1494.     <name>QIconView::sorting</name>
  1495.     <doc href="qiconview.html#sorting-prop"> <p>This property holds whether the icon view sorts on insertion.
  1496. <p>The default is FALSE, i.e. no sorting on insertion.
  1497. <p> To set the soring, use <a href="qiconview.html#setSorting">setSorting</a>().
  1498.  
  1499. <p>Get this property's value with <a href="qiconview.html#sorting">sorting</a>().
  1500. </doc>
  1501. </property>
  1502. <property>
  1503.     <name>QIconView::spacing</name>
  1504.     <doc href="qiconview.html#spacing-prop"> <p>This property holds the space in pixels between icon view items.
  1505. <p>The default is 5 pixels.
  1506. <p> Negative values for spacing are illegal.
  1507.  
  1508. <p>Set this property's value with <a href="qiconview.html#setSpacing">setSpacing</a>() and get this property's value with <a href="qiconview.html#spacing">spacing</a>().
  1509. </doc>
  1510. </property>
  1511. <property>
  1512.     <name>QIconView::wordWrapIconText</name>
  1513.     <doc href="qiconview.html#wordWrapIconText-prop"> <p>This property holds whether the item text will be word-wrapped if it is too long.
  1514. <p>The default is TRUE.
  1515. <p> If this property is FALSE, icon text that is too long is truncated,
  1516. and an ellipsis (...) appended to indicate that truncation has
  1517. occurred.
  1518.  
  1519. <p>Set this property's value with <a href="qiconview.html#setWordWrapIconText">setWordWrapIconText</a>() and get this property's value with <a href="qiconview.html#wordWrapIconText">wordWrapIconText</a>().
  1520. </doc>
  1521. </property>
  1522. <property>
  1523.     <name>QIntValidator::bottom</name>
  1524.     <doc href="qintvalidator.html#bottom-prop"> <p>This property holds the validator's lowest acceptable value.
  1525. <p>Set this property's value with <a href="qintvalidator.html#setBottom">setBottom</a>() and get this property's value with <a href="qintvalidator.html#bottom">bottom</a>().
  1526. <p><p>See also <a href="qintvalidator.html#setRange">setRange</a>().
  1527.  
  1528. </doc>
  1529. </property>
  1530. <property>
  1531.     <name>QIntValidator::top</name>
  1532.     <doc href="qintvalidator.html#top-prop"> <p>This property holds the validator's highest acceptable value.
  1533. <p>Set this property's value with <a href="qintvalidator.html#setTop">setTop</a>() and get this property's value with <a href="qintvalidator.html#top">top</a>().
  1534. <p><p>See also <a href="qintvalidator.html#setRange">setRange</a>().
  1535.  
  1536. </doc>
  1537. </property>
  1538. <property>
  1539.     <name>QLCDNumber::intValue</name>
  1540.     <doc href="qlcdnumber.html#intValue-prop">
  1541. <p>This property holds the displayed value rounded to the nearest integer.
  1542. <p>This property corresponds to the nearest integer to the
  1543. current value displayed by the LCDNumber.
  1544. <p> If the displayed value is not a number, the property has
  1545. a value of 0.
  1546.  
  1547. <p>Set this property's value with <a href="qlcdnumber.html#display">display</a>() and get this property's value with <a href="qlcdnumber.html#intValue">intValue</a>().
  1548. </doc>
  1549. </property>
  1550. <property>
  1551.     <name>QLCDNumber::mode</name>
  1552.     <doc href="qlcdnumber.html#mode-prop">
  1553. <p>This property holds the current display mode (number base).
  1554. <p>Corresponds to the current display mode, which is one of <a href="qlcdnumber.html#Mode-enum">BIN</a>, <a href="qlcdnumber.html#Mode-enum">OCT</a>, <a href="qlcdnumber.html#Mode-enum">DEC</a> (the default) and <a href="qlcdnumber.html#Mode-enum">HEX</a>. All four modes can display
  1555. both integers, floating-point numbers and strings (subject to
  1556. character set limitations).
  1557. <p> <p>See also <a href="qlcdnumber.html#smallDecimalPoint-prop">smallDecimalPoint</a>, <a href="qlcdnumber.html#setHexMode">setHexMode</a>(), <a href="qlcdnumber.html#setDecMode">setDecMode</a>(), <a href="qlcdnumber.html#setOctMode">setOctMode</a>() and <a href="qlcdnumber.html#setBinMode">setBinMode</a>().
  1558.  
  1559. <p>Set this property's value with <a href="qlcdnumber.html#setMode">setMode</a>() and get this property's value with <a href="qlcdnumber.html#mode">mode</a>().
  1560. </doc>
  1561. </property>
  1562. <property>
  1563.     <name>QLCDNumber::numDigits</name>
  1564.     <doc href="qlcdnumber.html#numDigits-prop">
  1565. <p>This property holds the current number of digits displayed.
  1566. <p>Corresponds to the current number of digits.  If <a href="qlcdnumber.html#smallDecimalPoint-prop">QLCDNumber::smallDecimalPoint</a> is FALSE, the decimal point occupies
  1567. one digit position.
  1568. <p> <p>See also <a href="qlcdnumber.html#numDigits-prop">numDigits</a> and <a href="qlcdnumber.html#smallDecimalPoint-prop">smallDecimalPoint</a>.
  1569.  
  1570. <p>Set this property's value with <a href="qlcdnumber.html#setNumDigits">setNumDigits</a>() and get this property's value with <a href="qlcdnumber.html#numDigits">numDigits</a>().
  1571. </doc>
  1572. </property>
  1573. <property>
  1574.     <name>QLCDNumber::segmentStyle</name>
  1575.     <doc href="qlcdnumber.html#segmentStyle-prop">
  1576. <p>This property holds the style of the LCDNumber.
  1577. <p>The style of the QLCDNumber is one of:
  1578. <ul>
  1579. <li> <a href="qlcdnumber.html#SegmentStyle-enum">Outline</a> gives raised segments filled with the background color (this is the default).
  1580. <li> <a href="qlcdnumber.html#SegmentStyle-enum">Filled</a> gives raised segments filled with the foreground color.
  1581. <li> <a href="qlcdnumber.html#SegmentStyle-enum">Flat</a> gives flat segments filled with the foreground color.
  1582. </ul>
  1583. <p> <a href="qlcdnumber.html#SegmentStyle-enum">Outline</a> and <a href="qlcdnumber.html#SegmentStyle-enum">Filled</a> will additionally use <a href="qcolorgroup.html#light">QColorGroup::light</a>()
  1584. and <a href="qcolorgroup.html#dark">QColorGroup::dark</a>() for shadow effects.
  1585. <p> 
  1586. <p>Set this property's value with <a href="qlcdnumber.html#setSegmentStyle">setSegmentStyle</a>() and get this property's value with <a href="qlcdnumber.html#segmentStyle">segmentStyle</a>().
  1587. </doc>
  1588. </property>
  1589. <property>
  1590.     <name>QLCDNumber::smallDecimalPoint</name>
  1591.     <doc href="qlcdnumber.html#smallDecimalPoint-prop">
  1592. <p>This property holds the style of the decimal point.
  1593. <p>If TRUE the decimal point is drawn between two
  1594. digit positions. Otherwise it occupies a digit position of its own,
  1595. i.e. is drawn in a digit position. The default is FALSE.
  1596. <p> The inter-digit space is made slightly wider when the decimal point
  1597. is drawn between the digits.
  1598. <p> <p>See also <a href="qlcdnumber.html#mode-prop">mode</a>.
  1599.  
  1600. <p>Set this property's value with <a href="qlcdnumber.html#setSmallDecimalPoint">setSmallDecimalPoint</a>() and get this property's value with <a href="qlcdnumber.html#smallDecimalPoint">smallDecimalPoint</a>().
  1601. </doc>
  1602. </property>
  1603. <property>
  1604.     <name>QLCDNumber::value</name>
  1605.     <doc href="qlcdnumber.html#value-prop">
  1606. <p>This property holds the displayed value.
  1607. <p>This property corresponds to the current value displayed by the
  1608. LCDNumber.
  1609. <p> If the displayed value is not a number, the property has
  1610. a value of 0.
  1611.  
  1612. <p>Set this property's value with <a href="qlcdnumber.html#display">display</a>() and get this property's value with <a href="qlcdnumber.html#value">value</a>().
  1613. </doc>
  1614. </property>
  1615. <property>
  1616.     <name>QLabel::alignment</name>
  1617.     <doc href="qlabel.html#alignment-prop">
  1618. <p>This property holds the alignment of the label's contents.
  1619. <p>The alignment is a bitwise OR of Qt::AlignmentFlags and
  1620. Qt::TextFlags values. The <a href="qt.html#TextFlags-enum">ExpandTabs</a>, <a href="qt.html#TextFlags-enum">SingleLine</a> and <a href="qt.html#TextFlags-enum">ShowPrefix</a> flags apply only if the label contains plain text;
  1621. otherwise they are ignored. The <a href="qt.html#TextFlags-enum">DontClip</a> flag is always
  1622. ignored. <a href="qt.html#TextFlags-enum">WordBreak</a> applies to both rich text and plain text
  1623. labels.
  1624. <p> If the label has a buddy, the <a href="qt.html#TextFlags-enum">ShowPrefix</a> flag is forced to TRUE.
  1625. <p> The default alignment is <tt>AlignAuto | AlignVCenter | ExpandTabs</tt>
  1626. if the label doesn't have a buddy and <tt>AlignAuto | AlignVCenter | ExpandTabs | ShowPrefix</tt> if the label has a buddy. If the label
  1627. contains rich text, additionally <a href="qt.html#TextFlags-enum">WordBreak</a> is turned on.
  1628. <p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>, <a href="qlabel.html#alignment-prop">alignment</a>, <a href="qlabel.html#setBuddy">setBuddy</a>() and <a href="qlabel.html#text-prop">text</a>.
  1629.  
  1630. <p>Set this property's value with <a href="qlabel.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qlabel.html#alignment">alignment</a>().
  1631. </doc>
  1632. </property>
  1633. <property>
  1634.     <name>QLabel::indent</name>
  1635.     <doc href="qlabel.html#indent-prop">
  1636. <p>This property holds the label's indent in pixels.
  1637. <p>The indent applies to the left edge if <a href="qlabel.html#alignment">alignment</a>() is <a href="qt.html#AlignmentFlags-enum">AlignLeft</a>,
  1638. to the right edge if alignment() is <a href="qt.html#AlignmentFlags-enum">AlignRight</a>, to the top edge
  1639. if alignment() is <a href="qt.html#AlignmentFlags-enum">AlignTop</a>, and to to the bottom edge if
  1640. alignment() is <a href="qt.html#AlignmentFlags-enum">AlignBottom</a>.
  1641. <p> If the indent is negative, or if no indent has been set, the label
  1642. computes the effective indent as follows: if <a href="qframe.html#frameWidth">frameWidth</a>() is 0, the
  1643. effective indent becomes 0. If frameWidth() is greater than 0, the
  1644. effective indent becomes half the width of the "x" character of the
  1645. widget's current <a href="qwidget.html#font">font</a>().
  1646. <p> <p>See also <a href="qlabel.html#alignment-prop">alignment</a>, <a href="qframe.html#frameWidth-prop">frameWidth</a> and <a href="qwidget.html#font-prop">font</a>.
  1647.  
  1648. <p>Set this property's value with <a href="qlabel.html#setIndent">setIndent</a>() and get this property's value with <a href="qlabel.html#indent">indent</a>().
  1649. </doc>
  1650. </property>
  1651. <property>
  1652.     <name>QLabel::pixmap</name>
  1653.     <doc href="qlabel.html#pixmap-prop">
  1654. <p>This property holds the label's pixmap.
  1655. <p>If no pixmap has been set this will return an invalid pixmap.
  1656. <p> Setting the pixmap clears any previous content, and resizes the label
  1657. if <a href="qlabel.html#autoResize">QLabel::autoResize</a>() is TRUE. The buddy accelerator, if any,
  1658. is disabled.
  1659.  
  1660. <p>Set this property's value with <a href="qlabel.html#setPixmap">setPixmap</a>() and get this property's value with <a href="qlabel.html#pixmap">pixmap</a>().
  1661. </doc>
  1662. </property>
  1663. <property>
  1664.     <name>QLabel::scaledContents</name>
  1665.     <doc href="qlabel.html#scaledContents-prop">
  1666. <p>This property holds whether the label will scale its contents to fill all available space.
  1667. <p>When enabled and the label shows a pixmap, it will scale the pixmap to
  1668. fill the available space.
  1669. <p> This property's default is FALSE.
  1670. <p> <p>See also <a href="qlabel.html#scaledContents-prop">scaledContents</a>.
  1671.  
  1672. <p>Set this property's value with <a href="qlabel.html#setScaledContents">setScaledContents</a>() and get this property's value with <a href="qlabel.html#hasScaledContents">hasScaledContents</a>().
  1673. </doc>
  1674. </property>
  1675. <property>
  1676.     <name>QLabel::text</name>
  1677.     <doc href="qlabel.html#text-prop">
  1678. <p>This property holds the label text.
  1679. <p>If no text has been set this will return an empty string. Setting the
  1680. text clears any previous content, unless they are the same.
  1681. <p> The text will be interpreted either as a plain text or as a rich text,
  1682. depending on the text format setting; see <a href="qlabel.html#setTextFormat">setTextFormat</a>(). The default
  1683. setting is <a href="qt.html#TextFormat-enum">AutoText</a>, i.e. QLabel will try to auto-detect the format
  1684. of the text set.
  1685. <p> If the text is interpreted as a plain text and a buddy has been set, the
  1686. buddy accelerator key is updated from the new text.
  1687. <p> The label resizes itself if auto-resizing is enabled.
  1688. <p> Note that Qlabel is well-suited to display small rich text documents
  1689. only. Those small documents get their document specific settings
  1690. (font, text color, link color) from the label's palette and font
  1691. properties. For large documents, use QTextView instead. QTextView
  1692. will flicker less on resize and can also provide a scrollbar, when
  1693. necessary.
  1694. <p> <p>See also <a href="qlabel.html#text-prop">text</a>, <a href="qlabel.html#textFormat-prop">textFormat</a>, <a href="qlabel.html#setBuddy">setBuddy</a>() and <a href="qlabel.html#alignment-prop">alignment</a>.
  1695.  
  1696. <p>Set this property's value with <a href="qlabel.html#setText">setText</a>() and get this property's value with <a href="qlabel.html#text">text</a>().
  1697. </doc>
  1698. </property>
  1699. <property>
  1700.     <name>QLabel::textFormat</name>
  1701.     <doc href="qlabel.html#textFormat-prop">
  1702. <p>This property holds the label's text format.
  1703. <p>See the Qt::TextFormat enum for an explanation of the possible options.
  1704. <p> The default format is <a href="qt.html#TextFormat-enum">AutoText</a>.
  1705. <p> <p>See also <a href="qlabel.html#text-prop">text</a>.
  1706.  
  1707. <p>Set this property's value with <a href="qlabel.html#setTextFormat">setTextFormat</a>() and get this property's value with <a href="qlabel.html#textFormat">textFormat</a>().
  1708. </doc>
  1709. </property>
  1710. <property>
  1711.     <name>QLayout::margin</name>
  1712.     <doc href="qlayout.html#margin-prop">
  1713. <p>This property holds the width of the outside border of the layout.
  1714. <p>For some layout classes this property has an effect only on
  1715. top-level layouts; <a href="qboxlayout.html">QBoxLayout</a> and <a href="qgridlayout.html">QGridLayout</a> support margins for
  1716. child layouts. The default value is 0.
  1717. <p> <p>See also <a href="qlayout.html#spacing-prop">spacing</a>.
  1718.  
  1719. <p>Set this property's value with <a href="qlayout.html#setMargin">setMargin</a>() and get this property's value with <a href="qlayout.html#margin">margin</a>().
  1720. </doc>
  1721. </property>
  1722. <property>
  1723.     <name>QLayout::resizeMode</name>
  1724.     <doc href="qlayout.html#resizeMode-prop">
  1725. <p>This property holds the resize mode of the layout.
  1726. <p>The default mode is <a href="qlayout.html#ResizeMode-enum">Minimum</a> for top-level widgets and <a href="qlayout.html#ResizeMode-enum">FreeResize</a>
  1727. for all others.
  1728. <p> <p>See also <a href="qlayout.html#ResizeMode-enum">QLayout::ResizeMode</a>.
  1729.  
  1730. <p>Set this property's value with <a href="qlayout.html#setResizeMode">setResizeMode</a>() and get this property's value with <a href="qlayout.html#resizeMode">resizeMode</a>().
  1731. </doc>
  1732. </property>
  1733. <property>
  1734.     <name>QLayout::spacing</name>
  1735.     <doc href="qlayout.html#spacing-prop">
  1736. <p>This property holds the spacing between widgets inside the layout.
  1737. <p>The default value is -1, which signifies that the layout's spacing
  1738. should not override the widget's spacing.
  1739. <p> <p>See also <a href="qlayout.html#margin-prop">margin</a>.
  1740.  
  1741. <p>Set this property's value with <a href="qlayout.html#setSpacing">setSpacing</a>() and get this property's value with <a href="qlayout.html#spacing">spacing</a>().
  1742. </doc>
  1743. </property>
  1744. <property>
  1745.     <name>QLineEdit::alignment</name>
  1746.     <doc href="qlineedit.html#alignment-prop"> <p>This property holds the alignment of the line edit.
  1747. <p>Possible Values are Qt::AlignAuto, Qt::AlignLeft,
  1748. Qt::AlignRight and Qt::AlignHCenter.
  1749. <p> Attempting to set the alignment to an illegal flag combination does
  1750. nothing.
  1751. <p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>.
  1752.  
  1753. <p>Set this property's value with <a href="qlineedit.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qlineedit.html#alignment">alignment</a>().
  1754. </doc>
  1755. </property>
  1756. <property>
  1757.     <name>QLineEdit::cursorPosition</name>
  1758.     <doc href="qlineedit.html#cursorPosition-prop"> <p>This property holds the current cursor position for this line edit.
  1759. <p>Setting the cursor position causes a repaint when appropriate.
  1760.  
  1761. <p>Set this property's value with <a href="qlineedit.html#setCursorPosition">setCursorPosition</a>() and get this property's value with <a href="qlineedit.html#cursorPosition">cursorPosition</a>().
  1762. </doc>
  1763. </property>
  1764. <property>
  1765.     <name>QLineEdit::displayText</name>
  1766.     <doc href="qlineedit.html#displayText-prop"> <p>This property holds the text that is displayed.
  1767. <p>If EchoMode is Normal this returns the same as <a href="qlineedit.html#text">text</a>(); if EchoMode
  1768. is Password it returns a string of asterisks the text().length()
  1769. characters long, e.g. "******"; if EchoMode is NoEcho returns an
  1770. empty string, "".
  1771. <p> <p>See also <a href="qlineedit.html#echoMode-prop">echoMode</a>, <a href="qlineedit.html#text-prop">text</a> and <a href="qlineedit.html#EchoMode-enum">EchoMode</a>.
  1772.  
  1773. <p>Get this property's value with <a href="qlineedit.html#displayText">displayText</a>().
  1774. </doc>
  1775. </property>
  1776. <property>
  1777.     <name>QLineEdit::dragEnabled</name>
  1778.     <doc href="qlineedit.html#dragEnabled-prop"> <p>This property holds whether the lineedit starts a drag if the user presses and moves the mouse on some selected text.
  1779. <p>
  1780. <p>Set this property's value with <a href="qlineedit.html#setDragEnabled">setDragEnabled</a>() and get this property's value with <a href="qlineedit.html#dragEnabled">dragEnabled</a>().
  1781. </doc>
  1782. </property>
  1783. <property>
  1784.     <name>QLineEdit::echoMode</name>
  1785.     <doc href="qlineedit.html#echoMode-prop"> <p>This property holds the echo mode of the line edit.
  1786. <p>The initial setting is Normal, but QLineEdit also supports NoEcho
  1787. and Password modes.
  1788. <p> The widget's display and the ability to copy or drag the text is
  1789. affected by this setting.
  1790. <p> <p>See also <a href="qlineedit.html#EchoMode-enum">EchoMode</a> and <a href="qlineedit.html#displayText-prop">displayText</a>.
  1791.  
  1792. <p>Set this property's value with <a href="qlineedit.html#setEchoMode">setEchoMode</a>() and get this property's value with <a href="qlineedit.html#echoMode">echoMode</a>().
  1793. </doc>
  1794. </property>
  1795. <property>
  1796.     <name>QLineEdit::edited</name>
  1797.     <doc href="qlineedit.html#edited-prop"> <p>This property holds the edited flag of the line edit.
  1798. <p>The edited flag is never read by QLineEdit; it has a default value of
  1799. FALSE and is changed to TRUE whenever the user changes the line edit's
  1800. contents.
  1801. <p> This is useful for things that need to provide a default value
  1802. but cannot find the default at once.  Just start the line edit without
  1803. the best default; when the default is known, check the <a href="qlineedit.html#edited">edited</a>()
  1804. return value and set the line edit's contents if the user has not
  1805. started editing the line edit.
  1806. <p> Calling <a href="qlineedit.html#setText">setText</a>() resets the edited flag to FALSE.
  1807.  
  1808. <p>Set this property's value with <a href="qlineedit.html#setEdited">setEdited</a>() and get this property's value with <a href="qlineedit.html#edited">edited</a>().
  1809. </doc>
  1810. </property>
  1811. <property>
  1812.     <name>QLineEdit::frame</name>
  1813.     <doc href="qlineedit.html#frame-prop"> <p>This property holds whether the line edit draws itself with a frame.
  1814. <p>If enabled (the default) the line edit draws itself inside a
  1815. two-pixel frame, otherwise the line edit draws itself without
  1816. any frame.
  1817.  
  1818. <p>Set this property's value with <a href="qlineedit.html#setFrame">setFrame</a>() and get this property's value with <a href="qlineedit.html#frame">frame</a>().
  1819. </doc>
  1820. </property>
  1821. <property>
  1822.     <name>QLineEdit::hasMarkedText</name>
  1823.     <doc href="qlineedit.html#hasMarkedText-prop">
  1824. <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  1825. <p> <p>This property holds whether part of the text has been selected by the user (e.g. by clicking and dragging).
  1826. <p>Get this property's value with <a href="qlineedit.html#hasMarkedText">hasMarkedText</a>().
  1827. <p><p>See also <a href="qlineedit.html#selectedText-prop">selectedText</a>.
  1828.  
  1829. </doc>
  1830. </property>
  1831. <property>
  1832.     <name>QLineEdit::hasSelectedText</name>
  1833.     <doc href="qlineedit.html#hasSelectedText-prop">
  1834. <p>This property holds whether there is any text selected.
  1835. <p>hasSelectedText() returns TRUE if some or all of the text has been
  1836. selected by the user (e.g. by clicking and dragging); otherwise
  1837. returns FALSE.
  1838. <p> <p>See also <a href="qlineedit.html#selectedText-prop">selectedText</a>.
  1839.  
  1840. <p>Get this property's value with <a href="qlineedit.html#hasSelectedText">hasSelectedText</a>().
  1841. </doc>
  1842. </property>
  1843. <property>
  1844.     <name>QLineEdit::markedText</name>
  1845.     <doc href="qlineedit.html#markedText-prop">
  1846. <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  1847. <p> <p>This property holds the text selected by the user (e.g. by clicking and dragging), or QString::null if no text is selected.
  1848. <p>Get this property's value with <a href="qlineedit.html#markedText">markedText</a>().
  1849. <p><p>See also <a href="qlineedit.html#hasSelectedText-prop">hasSelectedText</a>.
  1850.  
  1851. </doc>
  1852. </property>
  1853. <property>
  1854.     <name>QLineEdit::maxLength</name>
  1855.     <doc href="qlineedit.html#maxLength-prop"> <p>This property holds the maximum permitted length of the text in the editor.
  1856. <p>If the text is too long, it is truncated at the limit.
  1857. <p> If truncation occurs any selected text will be unselected, the
  1858. cursor position is set to 0 and the first part of the string is
  1859. shown.
  1860.  
  1861. <p>Set this property's value with <a href="qlineedit.html#setMaxLength">setMaxLength</a>() and get this property's value with <a href="qlineedit.html#maxLength">maxLength</a>().
  1862. </doc>
  1863. </property>
  1864. <property>
  1865.     <name>QLineEdit::readOnly</name>
  1866.     <doc href="qlineedit.html#readOnly-prop"> <p>This property holds whether the line edit is read only.
  1867. <p>In read-only mode, the user can still copy the text to the
  1868. clipboard or drag-and-drop the text, but cannot edit it.
  1869. <p> QLineEdit does not show a cursor in read-only mode.
  1870. <p> <p>See also <a href="qwidget.html#enabled-prop">enabled</a>.
  1871.  
  1872. <p>Set this property's value with <a href="qlineedit.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qlineedit.html#isReadOnly">isReadOnly</a>().
  1873. </doc>
  1874. </property>
  1875. <property>
  1876.     <name>QLineEdit::redoAvailable</name>
  1877.     <doc href="qlineedit.html#redoAvailable-prop">
  1878. <p>This property holds whether redo is available.
  1879. <p>
  1880. <p>Get this property's value with <a href="qlineedit.html#isRedoAvailable">isRedoAvailable</a>().
  1881. </doc>
  1882. </property>
  1883. <property>
  1884.     <name>QLineEdit::selectedText</name>
  1885.     <doc href="qlineedit.html#selectedText-prop">
  1886. <p>This property holds any text selected by the user or QString::null.
  1887. <p>Get this property's value with <a href="qlineedit.html#selectedText">selectedText</a>().
  1888. <p><p>See also <a href="qlineedit.html#hasSelectedText-prop">hasSelectedText</a>.
  1889.  
  1890. </doc>
  1891. </property>
  1892. <property>
  1893.     <name>QLineEdit::text</name>
  1894.     <doc href="qlineedit.html#text-prop"> <p>This property holds the text in the line.
  1895. <p>Setting this property clears the selection, moves the cursor to the end
  1896. of the line and resets the edited property to FALSE.
  1897. <p> The text is truncated to <a href="qlineedit.html#maxLength">maxLength</a>() length.
  1898.  
  1899. <p>Set this property's value with <a href="qlineedit.html#setText">setText</a>() and get this property's value with <a href="qlineedit.html#text">text</a>().
  1900. </doc>
  1901. </property>
  1902. <property>
  1903.     <name>QLineEdit::undoAvailable</name>
  1904.     <doc href="qlineedit.html#undoAvailable-prop">
  1905. <p>This property holds whether undo is available.
  1906. <p>
  1907. <p>Get this property's value with <a href="qlineedit.html#isUndoAvailable">isUndoAvailable</a>().
  1908. </doc>
  1909. </property>
  1910. <property>
  1911.     <name>QListBox::columnMode</name>
  1912.     <doc href="qlistbox.html#columnMode-prop">
  1913. <p>This property holds the column layout mode for this list box.
  1914. <p>Set this property's value with <a href="qlistbox.html#setColumnMode">setColumnMode</a>() and get this property's value with <a href="qlistbox.html#columnMode">columnMode</a>().
  1915. <p><p>See also <a href="qlistbox.html#rowMode-prop">rowMode</a> and <a href="qlistbox.html#columnMode-prop">columnMode</a>.
  1916.  
  1917. <p> <a href="qlistbox.html#setColumnMode">setColumnMode</a>() sets the layout mode and adjusts the number of
  1918. displayed columns. The row layout mode automatically becomes
  1919. <a href="qlistbox.html#LayoutMode-enum">Variable</a>, unless the column mode is <a href="qlistbox.html#LayoutMode-enum">Variable</a>.
  1920. <p> <p>See also <a href="qlistbox.html#rowMode-prop">rowMode</a> and <a href="qlistbox.html#columnMode-prop">columnMode</a>.
  1921.  
  1922. </doc>
  1923. </property>
  1924. <property>
  1925.     <name>QListBox::count</name>
  1926.     <doc href="qlistbox.html#count-prop">
  1927. <p>This property holds the number of items in the list box.
  1928. <p>
  1929. <p>Get this property's value with <a href="qlistbox.html#count">count</a>().
  1930. </doc>
  1931. </property>
  1932. <property>
  1933.     <name>QListBox::currentItem</name>
  1934.     <doc href="qlistbox.html#currentItem-prop">
  1935. <p>This property holds the current highlighted item.
  1936. <p>When setting this property, the highlighting is moved and the list
  1937. box scrolled as necessary.
  1938. <p> If no item has been selected, <a href="qlistbox.html#currentItem">currentItem</a>() returns -1.
  1939.  
  1940. <p>Set this property's value with <a href="qlistbox.html#setCurrentItem">setCurrentItem</a>() and get this property's value with <a href="qlistbox.html#currentItem">currentItem</a>().
  1941. </doc>
  1942. </property>
  1943. <property>
  1944.     <name>QListBox::currentText</name>
  1945.     <doc href="qlistbox.html#currentText-prop">
  1946. <p>This property holds the text of the current item.
  1947. <p>This is equivalent to <a href="qlistbox.html#text">text</a>(currentItem()).
  1948.  
  1949. <p>Get this property's value with <a href="qlistbox.html#currentText">currentText</a>().
  1950. </doc>
  1951. </property>
  1952. <property>
  1953.     <name>QListBox::multiSelection</name>
  1954.     <doc href="qlistbox.html#multiSelection-prop">
  1955. <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  1956. <p> <p>This property holds whether or not the list box is in Multi selection mode.
  1957. <p>Consider using the <a href="qlistbox.html#selectionMode-prop">QListBox::selectionMode</a> property instead of
  1958. this property.
  1959. <p> When setting this property, Multi selection mode is used if set to TRUE and
  1960. to Single selection mode if set to FALSE.
  1961. <p> When getting this property, TRUE is returned if the list box is in
  1962. Multi selection mode or Extended selection mode, and FALSE if it is
  1963. in Single selection mode or NoSelection mode.
  1964. <p> <p>See also <a href="qlistbox.html#selectionMode-prop">selectionMode</a>.
  1965.  
  1966. <p>Set this property's value with <a href="qlistbox.html#setMultiSelection">setMultiSelection</a>() and get this property's value with <a href="qlistbox.html#isMultiSelection">isMultiSelection</a>().
  1967. </doc>
  1968. </property>
  1969. <property>
  1970.     <name>QListBox::numColumns</name>
  1971.     <doc href="qlistbox.html#numColumns-prop">
  1972. <p>This property holds the number of columns in the list box.
  1973. <p>This is normally 1, but can be different if <a href="qlistbox.html#columnMode-prop">QListBox::columnMode</a> or
  1974. <a href="qlistbox.html#rowMode-prop">QListBox::rowMode</a> has been set.
  1975. <p> <p>See also <a href="qlistbox.html#columnMode-prop">columnMode</a>, <a href="qlistbox.html#rowMode-prop">rowMode</a> and <a href="qlistbox.html#numRows-prop">numRows</a>.
  1976.  
  1977. <p>Get this property's value with <a href="qlistbox.html#numColumns">numColumns</a>().
  1978. </doc>
  1979. </property>
  1980. <property>
  1981.     <name>QListBox::numItemsVisible</name>
  1982.     <doc href="qlistbox.html#numItemsVisible-prop">
  1983. <p>This property holds the number of visible items.
  1984. <p>Both partially and entirely visible items are counted.
  1985.  
  1986. <p>Get this property's value with <a href="qlistbox.html#numItemsVisible">numItemsVisible</a>().
  1987. </doc>
  1988. </property>
  1989. <property>
  1990.     <name>QListBox::numRows</name>
  1991.     <doc href="qlistbox.html#numRows-prop">
  1992. <p>This property holds the number of rows in the list box.
  1993. <p>This is equal to the number of items in the default single-column
  1994. layout, but can be different.
  1995. <p> <p>See also <a href="qlistbox.html#columnMode-prop">columnMode</a>, <a href="qlistbox.html#rowMode-prop">rowMode</a> and <a href="qlistbox.html#numColumns-prop">numColumns</a>.
  1996.  
  1997. <p>Get this property's value with <a href="qlistbox.html#numRows">numRows</a>().
  1998. </doc>
  1999. </property>
  2000. <property>
  2001.     <name>QListBox::rowMode</name>
  2002.     <doc href="qlistbox.html#rowMode-prop">
  2003. <p>This property holds the row layout mode for this list box.
  2004. <p>This property is normally <a href="qlistbox.html#LayoutMode-enum">Variable</a>.
  2005. <p> <a href="qlistbox.html#setRowMode">setRowMode</a>() sets the layout mode and adjusts the number of displayed
  2006. rows. The column layout mode automatically becomes <a href="qlistbox.html#LayoutMode-enum">Variable</a>, unless
  2007. the row mode is <a href="qlistbox.html#LayoutMode-enum">Variable</a>.
  2008. <p> <p>See also <a href="qlistbox.html#columnMode-prop">columnMode</a> and <a href="qlistbox.html#rowMode-prop">rowMode</a>.
  2009.  
  2010. <p>Set this property's value with <a href="qlistbox.html#setRowMode">setRowMode</a>() and get this property's value with <a href="qlistbox.html#rowMode">rowMode</a>().
  2011. </doc>
  2012. </property>
  2013. <property>
  2014.     <name>QListBox::selectionMode</name>
  2015.     <doc href="qlistbox.html#selectionMode-prop">
  2016. <p>This property holds the selection mode of the list box.
  2017. <p>Sets the list box's selection mode, which may be one of
  2018. <a href="qlistbox.html#SelectionMode-enum">Single</a> (the default), <a href="qlistbox.html#SelectionMode-enum">Extended</a>, <a href="qlistbox.html#SelectionMode-enum">Multi</a> or <a href="qlistbox.html#SelectionMode-enum">NoSelection</a>.
  2019. <p> <p>See also <a href="qlistbox.html#SelectionMode-enum">SelectionMode</a>.
  2020.  
  2021. <p>Set this property's value with <a href="qlistbox.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qlistbox.html#selectionMode">selectionMode</a>().
  2022. </doc>
  2023. </property>
  2024. <property>
  2025.     <name>QListBox::topItem</name>
  2026.     <doc href="qlistbox.html#topItem-prop">
  2027. <p>This property holds the index of an item at the top of the screen.
  2028. <p>When getting this property and the listbox has multiple columns, an
  2029. arbitrary item is selected and returned.
  2030. <p> When setting this property, the list box is scrolled so the item at
  2031. position <em>index</em> in the list is displayed in the top row of the
  2032. list box.
  2033.  
  2034. <p>Set this property's value with <a href="qlistbox.html#setTopItem">setTopItem</a>() and get this property's value with <a href="qlistbox.html#topItem">topItem</a>().
  2035. </doc>
  2036. </property>
  2037. <property>
  2038.     <name>QListBox::variableHeight</name>
  2039.     <doc href="qlistbox.html#variableHeight-prop">
  2040. <p>This property holds whether this list box has variable-height rows.
  2041. <p>When the list box has variable-height rows (the default), each
  2042. row is as high as the highest item in that row.  When it has
  2043. same-sized rows, all rows are as high as the highest item in
  2044. the list box.
  2045. <p> <p>See also <a href="qlistbox.html#variableWidth-prop">variableWidth</a>.
  2046.  
  2047. <p>Set this property's value with <a href="qlistbox.html#setVariableHeight">setVariableHeight</a>() and get this property's value with <a href="qlistbox.html#variableHeight">variableHeight</a>().
  2048. </doc>
  2049. </property>
  2050. <property>
  2051.     <name>QListBox::variableWidth</name>
  2052.     <doc href="qlistbox.html#variableWidth-prop">
  2053. <p>This property holds whether this list box has variable-width columns.
  2054. <p>When the list box has variable-width columns, each column is as
  2055. wide as the widest item in that column.  When it has same-sized
  2056. columns (the default), all columns are as wide as the widest item
  2057. in the list box.
  2058. <p> <p>See also <a href="qlistbox.html#variableHeight-prop">variableHeight</a>.
  2059.  
  2060. <p>Set this property's value with <a href="qlistbox.html#setVariableWidth">setVariableWidth</a>() and get this property's value with <a href="qlistbox.html#variableWidth">variableWidth</a>().
  2061. </doc>
  2062. </property>
  2063. <property>
  2064.     <name>QListView::allColumnsShowFocus</name>
  2065.     <doc href="qlistview.html#allColumnsShowFocus-prop"> <p>This property holds whether items should show keyboard focus using all columns.
  2066. <p>If this property is TRUE all columns will show focus and selection
  2067. states, otherwise only column 0 will show focus.
  2068. <p> The default is FALSE.
  2069. <p> Setting this to TRUE if it's not necessary may cause noticeable
  2070. flicker.
  2071.  
  2072. <p>Set this property's value with <a href="qlistview.html#setAllColumnsShowFocus">setAllColumnsShowFocus</a>() and get this property's value with <a href="qlistview.html#allColumnsShowFocus">allColumnsShowFocus</a>().
  2073. </doc>
  2074. </property>
  2075. <property>
  2076.     <name>QListView::childCount</name>
  2077.     <doc href="qlistview.html#childCount-prop"> <p>This property holds the number of parentless (top level) <a href="qlistviewitem.html">QListViewItem</a> objects in this QListView.
  2078. <p>Represents the current number of parentless (top level)
  2079. QListViewItem objects in this QListView, like
  2080. <a href="qlistviewitem.html#childCount">QListViewItem::childCount</a>() returns the number of child items for a
  2081. QListViewItem.
  2082. <p> <p>See also <a href="qlistviewitem.html#childCount">QListViewItem::childCount</a>().
  2083.  
  2084. <p>Get this property's value with <a href="qlistview.html#childCount">childCount</a>().
  2085. </doc>
  2086. </property>
  2087. <property>
  2088.     <name>QListView::columns</name>
  2089.     <doc href="qlistview.html#columns-prop"> <p>This property holds the number of columns in this list view.
  2090. <p>Get this property's value with <a href="qlistview.html#columns">columns</a>().
  2091. <p><p>See also <a href="qlistview.html#addColumn">addColumn</a>() and <a href="qlistview.html#removeColumn">removeColumn</a>().
  2092.  
  2093. </doc>
  2094. </property>
  2095. <property>
  2096.     <name>QListView::defaultRenameAction</name>
  2097.     <doc href="qlistview.html#defaultRenameAction-prop"> <p>This property holds whether the list view accepts the rename operation by default.
  2098. <p>If this property is Accept, and the user renames an item and the
  2099. editor looses focus (without the user pressing Enter), the item
  2100. will still be renamed. If the property's value is Reject, the item
  2101. will not be renamed unless the user presses Enter. The default is
  2102. Reject.
  2103.  
  2104. <p>Set this property's value with <a href="qlistview.html#setDefaultRenameAction">setDefaultRenameAction</a>() and get this property's value with <a href="qlistview.html#defaultRenameAction">defaultRenameAction</a>().
  2105. </doc>
  2106. </property>
  2107. <property>
  2108.     <name>QListView::itemMargin</name>
  2109.     <doc href="qlistview.html#itemMargin-prop"> <p>This property holds the advisory item margin that list items may use.
  2110. <p>The item margin defaults to one pixel and is the margin between the
  2111. item's edges and the area where it draws its contents.
  2112. <a href="qlistviewitem.html#paintFocus">QListViewItem::paintFocus</a>() draws in the margin.
  2113. <p> <p>See also <a href="qlistviewitem.html#paintCell">QListViewItem::paintCell</a>().
  2114.  
  2115. <p>Set this property's value with <a href="qlistview.html#setItemMargin">setItemMargin</a>() and get this property's value with <a href="qlistview.html#itemMargin">itemMargin</a>().
  2116. </doc>
  2117. </property>
  2118. <property>
  2119.     <name>QListView::multiSelection</name>
  2120.     <doc href="qlistview.html#multiSelection-prop"> <p>This property holds whether the list view is in multi-selection or single selection mode.
  2121. <p>If you enable multi-selection mode, it is possible to specify
  2122. whether or not this mode should be extended. Extended means that the
  2123. user can select multiple items only when pressing the Shift or
  2124. Ctrl key at the same time.
  2125. <p> The default selection mode is <a href="qlistview.html#SelectionMode-enum">Single</a>.
  2126. <p> <p>See also <a href="qlistview.html#selectionMode-prop">selectionMode</a>.
  2127.  
  2128. <p>Set this property's value with <a href="qlistview.html#setMultiSelection">setMultiSelection</a>() and get this property's value with <a href="qlistview.html#isMultiSelection">isMultiSelection</a>().
  2129. </doc>
  2130. </property>
  2131. <property>
  2132.     <name>QListView::resizeMode</name>
  2133.     <doc href="qlistview.html#resizeMode-prop"> <p>This property holds whether all, none or the last column should be resized.
  2134. <p>Specifies whether all, none or the last column should be resized to
  2135. fit the full width of the listview. The values for this property can
  2136. be one of the following: <a href="qlistview.html#ResizeMode-enum">NoColumn</a> (the default), <a href="qlistview.html#ResizeMode-enum">AllColumns</a> or
  2137. <a href="qlistview.html#ResizeMode-enum">LastColumn</a>.
  2138. <p> <p>See also <a href="qheader.html">QHeader</a> and <a href="qlistview.html#header">header</a>().
  2139.  
  2140. <p>Set this property's value with <a href="qlistview.html#setResizeMode">setResizeMode</a>() and get this property's value with <a href="qlistview.html#resizeMode">resizeMode</a>().
  2141. </doc>
  2142. </property>
  2143. <property>
  2144.     <name>QListView::rootIsDecorated</name>
  2145.     <doc href="qlistview.html#rootIsDecorated-prop"> <p>This property holds whether the list view show open/close signs on root items.
  2146. <p>Open/close signs are small + or - symbols in windows style, or
  2147. arrows in Motif style. The default is FALSE.
  2148.  
  2149. <p>Set this property's value with <a href="qlistview.html#setRootIsDecorated">setRootIsDecorated</a>() and get this property's value with <a href="qlistview.html#rootIsDecorated">rootIsDecorated</a>().
  2150. </doc>
  2151. </property>
  2152. <property>
  2153.     <name>QListView::selectionMode</name>
  2154.     <doc href="qlistview.html#selectionMode-prop"> <p>This property holds the list view's multi-selection mode.
  2155. <p>The mode can be <a href="qlistview.html#SelectionMode-enum">Single</a> (the default), <a href="qlistview.html#SelectionMode-enum">Extended</a>, <a href="qlistview.html#SelectionMode-enum">Multi</a> or
  2156. <a href="qlistview.html#SelectionMode-enum">NoSelection</a>.
  2157. <p> <p>See also <a href="qlistview.html#multiSelection-prop">multiSelection</a>.
  2158.  
  2159. <p>Set this property's value with <a href="qlistview.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qlistview.html#selectionMode">selectionMode</a>().
  2160. </doc>
  2161. </property>
  2162. <property>
  2163.     <name>QListView::showSortIndicator</name>
  2164.     <doc href="qlistview.html#showSortIndicator-prop"> <p>This property holds whether the list view header should display a sort indicator.
  2165. <p>If this property is TRUE, an arrow is drawn in the header of the
  2166. list view to indicate the sort order of the list view contents. The
  2167. arrow will be drawn in the correct column and will point up or down,
  2168. depending on the current sort direction. The default is FALSE (don't
  2169. show an indicator).
  2170. <p> <p>See also <a href="qheader.html#setSortIndicator">QHeader::setSortIndicator</a>().
  2171.  
  2172. <p>Set this property's value with <a href="qlistview.html#setShowSortIndicator">setShowSortIndicator</a>() and get this property's value with <a href="qlistview.html#showSortIndicator">showSortIndicator</a>().
  2173. </doc>
  2174. </property>
  2175. <property>
  2176.     <name>QListView::showToolTips</name>
  2177.     <doc href="qlistview.html#showToolTips-prop"> <p>This property holds whether this list view should show tooltips for truncated column texts.
  2178. <p>The default is TRUE.
  2179.  
  2180. <p>Set this property's value with <a href="qlistview.html#setShowToolTips">setShowToolTips</a>() and get this property's value with <a href="qlistview.html#showToolTips">showToolTips</a>().
  2181. </doc>
  2182. </property>
  2183. <property>
  2184.     <name>QListView::treeStepSize</name>
  2185.     <doc href="qlistview.html#treeStepSize-prop"> <p>This property holds the number of pixels a child is offset from its parent.
  2186. <p>The default is 20 pixels.
  2187. <p> Of course, this property is only meaningful for hierarchical list
  2188. views.
  2189.  
  2190. <p>Set this property's value with <a href="qlistview.html#setTreeStepSize">setTreeStepSize</a>() and get this property's value with <a href="qlistview.html#treeStepSize">treeStepSize</a>().
  2191. </doc>
  2192. </property>
  2193. <property>
  2194.     <name>QMainWindow::dockWindowsMovable</name>
  2195.     <doc href="qmainwindow.html#dockWindowsMovable-prop"> <p>This property holds whether the dock windows are movable.
  2196. <p>If TRUE (the default), the user will be able to move Movable dock
  2197. windows from one QMainWindow dock area to another, including the <tt>TearOff</tt> area (i.e. where the dock window floats freely as a window
  2198. in its own right), and the <a href="qt.html#Dock-enum">Minimized</a> area (where only the dock
  2199. window's handle is shown below the menu bar). Moveable dock windows
  2200. can also be moved within QMainWindow dock areas, i.e. to rearrange
  2201. them within a dock area.
  2202. <p> If FALSE the user will not be able to move any dock windows.
  2203. <p> By default dock windows are moved transparently (i.e. only an outline
  2204. rectangle is shown during the drag), but this setting can be changed
  2205. with <a href="qmainwindow.html#setOpaqueMoving">setOpaqueMoving</a>().
  2206. <p> <p>See also <a href="qmainwindow.html#setDockEnabled">setDockEnabled</a>() and <a href="qmainwindow.html#opaqueMoving-prop">opaqueMoving</a>.
  2207.  
  2208. <p> 
  2209. <p>Set this property's value with <a href="qmainwindow.html#setDockWindowsMovable">setDockWindowsMovable</a>() and get this property's value with <a href="qmainwindow.html#dockWindowsMovable">dockWindowsMovable</a>().
  2210. </doc>
  2211. </property>
  2212. <property>
  2213.     <name>QMainWindow::opaqueMoving</name>
  2214.     <doc href="qmainwindow.html#opaqueMoving-prop"> <p>This property holds whether dock windows are moved opaquely.
  2215. <p>If TRUE the dock windows of the main window are shown
  2216. opaquely (i.e. it shows the toolbar as it looks when docked) when
  2217. moved. If FALSE (the default) they are shown transparently,
  2218. (i.e. as an outline rectangle).
  2219. <p> Opaque moving of toolbars and dockwindows is known to have several
  2220. problems. We suggest not to use it at this point in time. We will
  2221. fix that behavior problems in a future release.
  2222.  
  2223. <p>Set this property's value with <a href="qmainwindow.html#setOpaqueMoving">setOpaqueMoving</a>() and get this property's value with <a href="qmainwindow.html#opaqueMoving">opaqueMoving</a>().
  2224. </doc>
  2225. </property>
  2226. <property>
  2227.     <name>QMainWindow::rightJustification</name>
  2228.     <doc href="qmainwindow.html#rightJustification-prop"> <p>This property holds whether the main window right-justifies its dock windows.
  2229. <p>If disabled (the default), stretchable dock windows
  2230. are expanded, and non-stretchable dock windows are given the minimum
  2231. space they need. Since most dock windows are not stretchable, this
  2232. usually results in a unjustified right edge (or unjustified bottom edge for a
  2233. vertical dock area). If enabled, the main window will
  2234. right-justify its dock windows.
  2235. <p> <p>See also <a href="qdockwindow.html#setVerticalStretchable">QDockWindow::setVerticalStretchable</a>() and <a href="qdockwindow.html#setHorizontalStretchable">QDockWindow::setHorizontalStretchable</a>().
  2236.  
  2237. <p>Set this property's value with <a href="qmainwindow.html#setRightJustification">setRightJustification</a>() and get this property's value with <a href="qmainwindow.html#rightJustification">rightJustification</a>().
  2238. </doc>
  2239. </property>
  2240. <property>
  2241.     <name>QMainWindow::usesBigPixmaps</name>
  2242.     <doc href="qmainwindow.html#usesBigPixmaps-prop"> <p>This property holds whether big pixmaps are enabled.
  2243. <p>If FALSE (the default), the tool buttons will use small
  2244. pixmaps; otherwise big pixmaps will be used.
  2245. <p> Tool buttons and other widgets that wish to respond to this setting
  2246. are responsible for reading the correct state on startup, and for
  2247. connecting to the main window's widget's <a href="qmainwindow.html#pixmapSizeChanged">pixmapSizeChanged</a>() signal.
  2248.  
  2249. <p>Set this property's value with <a href="qmainwindow.html#setUsesBigPixmaps">setUsesBigPixmaps</a>() and get this property's value with <a href="qmainwindow.html#usesBigPixmaps">usesBigPixmaps</a>().
  2250. </doc>
  2251. </property>
  2252. <property>
  2253.     <name>QMainWindow::usesTextLabel</name>
  2254.     <doc href="qmainwindow.html#usesTextLabel-prop"> <p>This property holds whether text labels for toolbar buttons are enabled.
  2255. <p>If disabled (the default), the tool buttons will not use
  2256. text labels. If enabled, text labels will be used.
  2257. <p> Tool buttons and other widgets that wish to respond to this setting
  2258. are responsible for reading the correct state on startup, and for
  2259. connecting to the main window's widget's <a href="qmainwindow.html#usesTextLabelChanged">usesTextLabelChanged</a>()
  2260. signal.
  2261. <p> <p>See also <a href="qtoolbutton.html#usesTextLabel-prop">QToolButton::usesTextLabel</a>.
  2262.  
  2263. <p>Set this property's value with <a href="qmainwindow.html#setUsesTextLabel">setUsesTextLabel</a>() and get this property's value with <a href="qmainwindow.html#usesTextLabel">usesTextLabel</a>().
  2264. </doc>
  2265. </property>
  2266. <property>
  2267.     <name>QMenuBar::defaultUp</name>
  2268.     <doc href="qmenubar.html#defaultUp-prop">
  2269. <p>This property holds the popup orientation.
  2270. <p>The default popup orientation. By default, menus pop "down" the
  2271. screen.  By setting the property to TRUE, the menu will pop "up".  You
  2272. might call this for menus that are <em>below</em> the document to which
  2273. they refer.
  2274. <p> If the menu would not fit on the screen, the other direction is used
  2275. rather than the default.
  2276.  
  2277. <p>Set this property's value with <a href="qmenubar.html#setDefaultUp">setDefaultUp</a>() and get this property's value with <a href="qmenubar.html#isDefaultUp">isDefaultUp</a>().
  2278. </doc>
  2279. </property>
  2280. <property>
  2281.     <name>QMenuBar::separator</name>
  2282.     <doc href="qmenubar.html#separator-prop">
  2283. <p>This property holds in which cases a menubar sparator is drawn.
  2284. <p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  2285. <p> 
  2286. <p>Set this property's value with <a href="qmenubar.html#setSeparator">setSeparator</a>() and get this property's value with <a href="qmenubar.html#separator">separator</a>().
  2287. </doc>
  2288. </property>
  2289. <property>
  2290.     <name>QMessageBox::icon</name>
  2291.     <doc href="qmessagebox.html#icon-prop">
  2292. <p>This property holds the messagebox icon.
  2293. <p>The icon of the message box can be one of the following predefined icons:
  2294. <ul>
  2295. <li> QMessageBox::NoIcon
  2296. <li> QMessageBox::Information
  2297. <li> QMessageBox::Warning
  2298. <li> QMessageBox::Critical
  2299. </ul>
  2300. <p> The actual pixmap used for displaying the icon depends on the current
  2301. <a href="qwidget.html#style">GUI style</a>.  You can also set a custom
  2302. pixmap icon using the <a href="qmessagebox.html#iconPixmap-prop">QMessageBox::iconPixmap</a> property. The
  2303. default icon is QMessageBox::NoIcon.
  2304. <p> <p>See also <a href="qmessagebox.html#iconPixmap-prop">iconPixmap</a>.
  2305.  
  2306. <p>Set this property's value with <a href="qmessagebox.html#setIcon">setIcon</a>() and get this property's value with <a href="qmessagebox.html#icon">icon</a>().
  2307. </doc>
  2308. </property>
  2309. <property>
  2310.     <name>QMessageBox::iconPixmap</name>
  2311.     <doc href="qmessagebox.html#iconPixmap-prop">
  2312. <p>This property holds the current icon.
  2313. <p>The icon currently used by the message box. Note that
  2314. it's often hard to draw one pixmap that looks appropriate in both
  2315. Motif and Windows GUI styles; you may want to draw two pixmaps.
  2316. <p> <p>See also <a href="qmessagebox.html#icon-prop">icon</a>.
  2317.  
  2318. <p>Set this property's value with <a href="qmessagebox.html#setIconPixmap">setIconPixmap</a>() and get this property's value with <a href="qmessagebox.html#iconPixmap">iconPixmap</a>().
  2319. </doc>
  2320. </property>
  2321. <property>
  2322.     <name>QMessageBox::text</name>
  2323.     <doc href="qmessagebox.html#text-prop">
  2324. <p>This property holds the message box text to be displayed.
  2325. <p>The text will be interpreted either as a plain text or as a rich
  2326. text, depending on the text format setting (<a href="qmessagebox.html#textFormat-prop">QMessageBox::textFormat</a>). The
  2327. default setting is <a href="qt.html#TextFormat-enum">AutoText</a>, i.e. the message box will try to
  2328. auto-detect the format of the text.
  2329. <p> The default value of the property is QString::null.
  2330. <p> <p>See also <a href="qmessagebox.html#textFormat-prop">textFormat</a>.
  2331.  
  2332. <p>Set this property's value with <a href="qmessagebox.html#setText">setText</a>() and get this property's value with <a href="qmessagebox.html#text">text</a>().
  2333. </doc>
  2334. </property>
  2335. <property>
  2336.     <name>QMessageBox::textFormat</name>
  2337.     <doc href="qmessagebox.html#textFormat-prop">
  2338. <p>This property holds the format of the text displayed by the message box.
  2339. <p>The current text format used by the message box.
  2340. See the <a href="qt.html#TextFormat-enum">Qt::TextFormat</a> enum for an explanation of the possible options.
  2341. <p> The default format is <a href="qt.html#TextFormat-enum">AutoText</a>.
  2342. <p> <p>See also <a href="qmessagebox.html#text-prop">text</a>.
  2343.  
  2344. <p>Set this property's value with <a href="qmessagebox.html#setTextFormat">setTextFormat</a>() and get this property's value with <a href="qmessagebox.html#textFormat">textFormat</a>().
  2345. </doc>
  2346. </property>
  2347. <property>
  2348.     <name>QMultiLineEdit::alignment</name>
  2349.     <doc href="qmultilineedit.html#alignment-prop">  <p>This property holds the editor's paragraph alignment.
  2350. <p>Sets the alignment to flag, which must be <a href="qt.html#AlignmentFlags-enum">AlignLeft</a>, <a href="qt.html#AlignmentFlags-enum">AlignHCenter</a> or <a href="qt.html#AlignmentFlags-enum">AlignRight</a>.
  2351. <p> If flag is an illegal flag nothing happens.
  2352. <p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>.
  2353.  
  2354. <p>Set this property's value with <a href="qmultilineedit.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qmultilineedit.html#alignment">alignment</a>().
  2355. </doc>
  2356. </property>
  2357. <property>
  2358.     <name>QMultiLineEdit::atBeginning</name>
  2359.     <doc href="qmultilineedit.html#atBeginning-prop"> <p>This property holds whether the cursor is placed at the beginning of the text.
  2360. <p>Get this property's value with <a href="qmultilineedit.html#atBeginning">atBeginning</a>().
  2361. <p><p>See also <a href="qmultilineedit.html#atEnd-prop">atEnd</a>.
  2362.  
  2363. </doc>
  2364. </property>
  2365. <property>
  2366.     <name>QMultiLineEdit::atEnd</name>
  2367.     <doc href="qmultilineedit.html#atEnd-prop"> <p>This property holds whether the cursor is placed at the end of the text.
  2368. <p>Get this property's value with <a href="qmultilineedit.html#atEnd">atEnd</a>().
  2369. <p><p>See also <a href="qmultilineedit.html#atBeginning-prop">atBeginning</a>.
  2370.  
  2371. </doc>
  2372. </property>
  2373. <property>
  2374.     <name>QMultiLineEdit::edited</name>
  2375.     <doc href="qmultilineedit.html#edited-prop">  <p>This property holds whether the document has been edited by the user.
  2376. <p>This is the same as <a href="qtextedit.html">QTextEdit</a>'s "modifed" property.
  2377. <p> <p>See also <a href="qtextedit.html#modified-prop">QTextEdit::modified</a>.
  2378.  
  2379. <p>Set this property's value with <a href="qmultilineedit.html#setEdited">setEdited</a>() and get this property's value with <a href="qmultilineedit.html#edited">edited</a>().
  2380. </doc>
  2381. </property>
  2382. <property>
  2383.     <name>QMultiLineEdit::numLines</name>
  2384.     <doc href="qmultilineedit.html#numLines-prop"> <p>This property holds the number of paragraphs in the editor.
  2385. <p>The count includes any empty paragraph at top and bottom, so for an
  2386. empty editor this method returns 1.
  2387.  
  2388. <p>Get this property's value with <a href="qmultilineedit.html#numLines">numLines</a>().
  2389. </doc>
  2390. </property>
  2391. <property>
  2392.     <name>QObject::name</name>
  2393.     <doc href="qobject.html#name-prop">
  2394. <p>This property holds the name of this object.
  2395. <p>You can find an object by name (and type) using <a href="qobject.html#child">child</a>(). You can
  2396. find a set of objects with <a href="qobject.html#queryList">queryList</a>().
  2397. <p> The object name is set by the constructor or by the <a href="qobject.html#setName">setName</a>()
  2398. function. The object name is not very useful in the current version
  2399. of Qt, but will become increasingly important in the future.
  2400. <p> If the object does not have a name, the <a href="qobject.html#name">name</a>() function returns
  2401. "unnamed", so printf() (used in <a href="qapplication.html#qDebug">qDebug</a>()) will not be asked to output a null
  2402. pointer. If you want a null pointer to be returned for unnamed objects, you
  2403. can call name( 0 ).
  2404. <p> <pre>
  2405.     <a href="qapplication.html#qDebug">qDebug</a>( "MyClass::setPrecision(): (%s) invalid precision %f",
  2406.             <a href="qobject.html#name">name</a>(), newPrecision );
  2407. </pre>
  2408.  
  2409. <p> <p>See also <a href="qobject.html#className">className</a>(), <a href="qobject.html#child">child</a>() and <a href="qobject.html#queryList">queryList</a>().
  2410.  
  2411. <p>Set this property's value with <a href="qobject.html#setName">setName</a>() and get this property's value with <a href="qobject.html#name">name</a>().
  2412. </doc>
  2413. </property>
  2414. <property>
  2415.     <name>QPopupMenu::checkable</name>
  2416.     <doc href="qpopupmenu.html#checkable-prop">
  2417. <p>This property holds whether the display of check marks on menu items is enabled.
  2418. <p>When TRUE, the display of check marks on menu items is enabled.
  2419. Checking is always enabled when in Windows-style.
  2420. <p> <p>See also <a href="qmenudata.html#setItemChecked">QMenuData::setItemChecked</a>().
  2421.  
  2422. <p>Set this property's value with <a href="qpopupmenu.html#setCheckable">setCheckable</a>() and get this property's value with <a href="qpopupmenu.html#isCheckable">isCheckable</a>().
  2423. </doc>
  2424. </property>
  2425. <property>
  2426.     <name>QProgressBar::centerIndicator</name>
  2427.     <doc href="qprogressbar.html#centerIndicator-prop">
  2428. <p>This property holds whether the indicator string should be centered.
  2429. <p>Changing this property sets <a href="qprogressbar.html#indicatorFollowsStyle-prop">QProgressBar::indicatorFollowsStyle</a>
  2430. to FALSE. The default is TRUE.
  2431.  
  2432. <p>Set this property's value with <a href="qprogressbar.html#setCenterIndicator">setCenterIndicator</a>() and get this property's value with <a href="qprogressbar.html#centerIndicator">centerIndicator</a>().
  2433. </doc>
  2434. </property>
  2435. <property>
  2436.     <name>QProgressBar::indicatorFollowsStyle</name>
  2437.     <doc href="qprogressbar.html#indicatorFollowsStyle-prop">
  2438. <p>This property holds whether the display of the indicator string should follow the GUI style.
  2439. <p>The default is TRUE.
  2440. <p> <p>See also <a href="qprogressbar.html#centerIndicator-prop">centerIndicator</a>.
  2441.  
  2442. <p>Set this property's value with <a href="qprogressbar.html#setIndicatorFollowsStyle">setIndicatorFollowsStyle</a>() and get this property's value with <a href="qprogressbar.html#indicatorFollowsStyle">indicatorFollowsStyle</a>().
  2443. </doc>
  2444. </property>
  2445. <property>
  2446.     <name>QProgressBar::percentageVisible</name>
  2447.     <doc href="qprogressbar.html#percentageVisible-prop">
  2448. <p>This property holds whether the current progress value is displayed.
  2449. <p>The default is TRUE.
  2450. <p> <p>See also <a href="qprogressbar.html#centerIndicator-prop">centerIndicator</a> and <a href="qprogressbar.html#indicatorFollowsStyle-prop">indicatorFollowsStyle</a>.
  2451.  
  2452. <p>Set this property's value with <a href="qprogressbar.html#setPercentageVisible">setPercentageVisible</a>() and get this property's value with <a href="qprogressbar.html#percentageVisible">percentageVisible</a>().
  2453. </doc>
  2454. </property>
  2455. <property>
  2456.     <name>QProgressBar::progress</name>
  2457.     <doc href="qprogressbar.html#progress-prop">
  2458. <p>This property holds the current amount of progress.
  2459. <p>This property is -1 if the progress counting has not started.
  2460.  
  2461. <p>Set this property's value with <a href="qprogressbar.html#setProgress">setProgress</a>() and get this property's value with <a href="qprogressbar.html#progress">progress</a>().
  2462. </doc>
  2463. </property>
  2464. <property>
  2465.     <name>QProgressBar::progressString</name>
  2466.     <doc href="qprogressbar.html#progressString-prop">
  2467. <p>This property holds the current amount of progress as a string.
  2468. <p>This property is QString::null if the progress counting has not started.
  2469.  
  2470. <p>Get this property's value with <a href="qprogressbar.html#progressString">progressString</a>().
  2471. </doc>
  2472. </property>
  2473. <property>
  2474.     <name>QProgressBar::totalSteps</name>
  2475.     <doc href="qprogressbar.html#totalSteps-prop">
  2476. <p>This property holds the total number of steps.
  2477. <p>If totalSteps is null, the progress bar will display a busy indicator.
  2478. <p> <p>See also <a href="qprogressbar.html#totalSteps-prop">totalSteps</a>.
  2479.  
  2480. <p>Set this property's value with <a href="qprogressbar.html#setTotalSteps">setTotalSteps</a>() and get this property's value with <a href="qprogressbar.html#totalSteps">totalSteps</a>().
  2481. </doc>
  2482. </property>
  2483. <property>
  2484.     <name>QProgressDialog::autoClose</name>
  2485.     <doc href="qprogressdialog.html#autoClose-prop">
  2486. <p>This property holds whether the dialog gets hidden by <a href="qprogressdialog.html#reset">reset</a>().
  2487. <p>The default is TRUE.
  2488. <p> <p>See also <a href="qprogressdialog.html#autoReset-prop">autoReset</a>.
  2489.  
  2490. <p>Set this property's value with <a href="qprogressdialog.html#setAutoClose">setAutoClose</a>() and get this property's value with <a href="qprogressdialog.html#autoClose">autoClose</a>().
  2491. </doc>
  2492. </property>
  2493. <property>
  2494.     <name>QProgressDialog::autoReset</name>
  2495.     <doc href="qprogressdialog.html#autoReset-prop">
  2496. <p>This property holds whether the progress dialog calls <a href="qprogressdialog.html#reset">reset</a>() as soon as <a href="qprogressdialog.html#progress">progress</a>() equals <a href="qprogressdialog.html#totalSteps">totalSteps</a>().
  2497. <p>The default is TRUE.
  2498. <p> <p>See also <a href="qprogressdialog.html#autoClose-prop">autoClose</a>.
  2499.  
  2500. <p>Set this property's value with <a href="qprogressdialog.html#setAutoReset">setAutoReset</a>() and get this property's value with <a href="qprogressdialog.html#autoReset">autoReset</a>().
  2501. </doc>
  2502. </property>
  2503. <property>
  2504.     <name>QProgressDialog::labelText</name>
  2505.     <doc href="qprogressdialog.html#labelText-prop">
  2506. <p>This property holds the label's text.
  2507. <p>The default text is QString::null.
  2508.  
  2509. <p>Set this property's value with <a href="qprogressdialog.html#setLabelText">setLabelText</a>() and get this property's value with <a href="qprogressdialog.html#labelText">labelText</a>().
  2510. </doc>
  2511. </property>
  2512. <property>
  2513.     <name>QProgressDialog::minimumDuration</name>
  2514.     <doc href="qprogressdialog.html#minimumDuration-prop">
  2515. <p>This property holds the time that the progress should run for before the dialog opens.
  2516. <p>The dialog will not appear if the anticipated duration of the
  2517. progressing task is less than the minimum duration.
  2518. <p> If set to 0, the dialog is always shown as soon as any progress
  2519. is set. The default is 4000.
  2520.  
  2521. <p>Set this property's value with <a href="qprogressdialog.html#setMinimumDuration">setMinimumDuration</a>() and get this property's value with <a href="qprogressdialog.html#minimumDuration">minimumDuration</a>().
  2522. </doc>
  2523. </property>
  2524. <property>
  2525.     <name>QProgressDialog::progress</name>
  2526.     <doc href="qprogressdialog.html#progress-prop">
  2527. <p>This property holds the current amount of progress made.
  2528. <p>For the progress dialog to work as expected, you should initially set
  2529. this property to 0 and finally set it to
  2530. <a href="qprogressdialog.html#totalSteps">QProgressDialog::totalSteps</a>(); you can call <a href="qprogressdialog.html#setProgress">setProgress</a>() any number of times
  2531. in-between.
  2532. <p> <b>Warning:</b> If the progress dialog is modal
  2533. (see <a href="qprogressdialog.html#QProgressDialog">QProgressDialog::QProgressDialog</a>()),
  2534. this function calls <a href="qapplication.html#processEvents">QApplication::processEvents</a>(), so take care that
  2535. this does not cause undesirable re-entrancy in your code. For example,
  2536. don't use a QProgressDialog inside a <a href="qwidget.html#paintEvent">paintEvent</a>()!
  2537. <p> <p>See also <a href="qprogressdialog.html#totalSteps-prop">totalSteps</a>.
  2538.  
  2539. <p>Set this property's value with <a href="qprogressdialog.html#setProgress">setProgress</a>() and get this property's value with <a href="qprogressdialog.html#progress">progress</a>().
  2540. </doc>
  2541. </property>
  2542. <property>
  2543.     <name>QProgressDialog::totalSteps</name>
  2544.     <doc href="qprogressdialog.html#totalSteps-prop">
  2545. <p>This property holds the total number of steps.
  2546. <p>The default is 0.
  2547.  
  2548. <p>Set this property's value with <a href="qprogressdialog.html#setTotalSteps">setTotalSteps</a>() and get this property's value with <a href="qprogressdialog.html#totalSteps">totalSteps</a>().
  2549. </doc>
  2550. </property>
  2551. <property>
  2552.     <name>QProgressDialog::wasCancelled</name>
  2553.     <doc href="qprogressdialog.html#wasCancelled-prop">
  2554. <p>This property holds whether the dialog was cancelled.
  2555. <p>Get this property's value with <a href="qprogressdialog.html#wasCancelled">wasCancelled</a>().
  2556. <p><p>See also <a href="qprogressdialog.html#progress-prop">progress</a>.
  2557.  
  2558. </doc>
  2559. </property>
  2560. <property>
  2561.     <name>QPushButton::autoDefault</name>
  2562.     <doc href="qpushbutton.html#autoDefault-prop"> <p>This property holds whether the push button is the auto default button.
  2563. <p>If this property is set to TRUE then the push button is the auto
  2564. default button in a dialog.
  2565. <p> An auto-default button automatically becomes the default push button
  2566. in a dialog when it receives the keyboard input focus.
  2567. <p> In some GUI styles a default button is drawn with an extra frame
  2568. around it, up to 3 pixels or more. Qt automatically keeps this space
  2569. free around auto-default buttons, i.e., auto-default buttons may have
  2570. a slightly larger size hint.
  2571. <p> This property's default is TRUE  for buttons that have a <a href="qdialog.html">QDialog</a> parent,
  2572. else FALSE.
  2573.  
  2574. <p>Set this property's value with <a href="qpushbutton.html#setAutoDefault">setAutoDefault</a>() and get this property's value with <a href="qpushbutton.html#autoDefault">autoDefault</a>().
  2575. </doc>
  2576. </property>
  2577. <property>
  2578.     <name>QPushButton::default</name>
  2579.     <doc href="qpushbutton.html#default-prop"> <p>This property holds whether the push button is the default button.
  2580. <p>If this property is set to TRUE then the push button will be pressed if the
  2581. user hits the Enter key in a dialog.
  2582. <p> The current default button gets clicked when the user presses the
  2583. Enter key, independently of which widget in the dialog currently
  2584. has the keyboard input focus.  Only one push button can at any time
  2585. be the default button.  This button is then displayed with an
  2586. additional frame (depending on the GUI style).
  2587. <p> The default button behavior is provided only in dialogs. Buttons
  2588. can always be clicked from the keyboard by pressing Return or the
  2589. spacebar when the button has focus.
  2590. <p> This property's default is FALSE.
  2591.  
  2592. <p>Set this property's value with <a href="qpushbutton.html#setDefault">setDefault</a>() and get this property's value with <a href="qpushbutton.html#isDefault">isDefault</a>().
  2593. </doc>
  2594. </property>
  2595. <property>
  2596.     <name>QPushButton::flat</name>
  2597.     <doc href="qpushbutton.html#flat-prop"> <p>This property holds whether the border is disabled.
  2598. <p>This property's default is FALSE.
  2599.  
  2600. <p>Set this property's value with <a href="qpushbutton.html#setFlat">setFlat</a>() and get this property's value with <a href="qpushbutton.html#isFlat">isFlat</a>().
  2601. </doc>
  2602. </property>
  2603. <property>
  2604.     <name>QPushButton::iconSet</name>
  2605.     <doc href="qpushbutton.html#iconSet-prop"> <p>This property holds the icon set on the push button.
  2606. <p>This property will return 0 if the push button has no iconset
  2607.  
  2608. <p>Set this property's value with <a href="qpushbutton.html#setIconSet">setIconSet</a>() and get this property's value with <a href="qpushbutton.html#iconSet">iconSet</a>().
  2609. </doc>
  2610. </property>
  2611. <property>
  2612.     <name>QPushButton::menuButton</name>
  2613.     <doc href="qpushbutton.html#menuButton-prop"> <p>This property holds whether the push button has a menu button on it.
  2614. <p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  2615. <p> If this property is set to TRUE, then a down arrow is drawn on the push
  2616. button to indicate that a menu will pop up if the user clicks on the
  2617. arrow.
  2618.  
  2619. <p>Get this property's value with <a href="qpushbutton.html#isMenuButton">isMenuButton</a>().
  2620. </doc>
  2621. </property>
  2622. <property>
  2623.     <name>QRadioButton::checked</name>
  2624.     <doc href="qradiobutton.html#checked-prop"> <p>This property holds whether the radio button is checked.
  2625. <p>This property will not effect any other radio buttons unless they have been
  2626. placed in the same <a href="qbuttongroup.html">QButtonGroup</a>. The default value is FALSE (unchecked).
  2627.  
  2628. <p>Set this property's value with <a href="qradiobutton.html#setChecked">setChecked</a>() and get this property's value with <a href="qradiobutton.html#isChecked">isChecked</a>().
  2629. </doc>
  2630. </property>
  2631. <property>
  2632.     <name>QScrollBar::draggingSlider</name>
  2633.     <doc href="qscrollbar.html#draggingSlider-prop">
  2634. <p>This property holds whether the user has clicked the mouse on the slider and is currently dragging it.
  2635. <p>
  2636. <p>Get this property's value with <a href="qscrollbar.html#draggingSlider">draggingSlider</a>().
  2637. </doc>
  2638. </property>
  2639. <property>
  2640.     <name>QScrollBar::lineStep</name>
  2641.     <doc href="qscrollbar.html#lineStep-prop">
  2642. <p>This property holds the current line step.
  2643. <p>When setting lineStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be called
  2644. if the new line step is different from the previous setting.
  2645. <p> <p>See also <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>() and <a href="qrangecontrol.html#setRange">setRange</a>().
  2646.  
  2647. <p>Set this property's value with <a href="qscrollbar.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qscrollbar.html#lineStep">lineStep</a>().
  2648. </doc>
  2649. </property>
  2650. <property>
  2651.     <name>QScrollBar::maxValue</name>
  2652.     <doc href="qscrollbar.html#maxValue-prop">
  2653. <p>This property holds the current maximum value of the scroll bar.
  2654. <p>When setting this property, the <a href="qscrollbar.html#minValue-prop">QScrollBar::minValue</a> is adjusted
  2655. so that the range remains valid if necessary.
  2656. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
  2657.  
  2658. <p>Set this property's value with <a href="qscrollbar.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qscrollbar.html#maxValue">maxValue</a>().
  2659. </doc>
  2660. </property>
  2661. <property>
  2662.     <name>QScrollBar::minValue</name>
  2663.     <doc href="qscrollbar.html#minValue-prop">
  2664. <p>This property holds the current minimum value of the scroll bar.
  2665. <p>When setting this property, the <a href="qscrollbar.html#maxValue-prop">QScrollBar::maxValue</a> is adjusted
  2666. so that the range remains valid if necessary.
  2667. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
  2668.  
  2669. <p>Set this property's value with <a href="qscrollbar.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qscrollbar.html#minValue">minValue</a>().
  2670. </doc>
  2671. </property>
  2672. <property>
  2673.     <name>QScrollBar::orientation</name>
  2674.     <doc href="qscrollbar.html#orientation-prop">
  2675. <p>This property holds the orientation of the scroll bar.
  2676. <p>The orientation must be <a href="qt.html#Orientation-enum">Qt::Vertical</a> (the default) or <a href="qt.html#Orientation-enum">Qt::Horizontal</a>.
  2677.  
  2678. <p>Set this property's value with <a href="qscrollbar.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qscrollbar.html#orientation">orientation</a>().
  2679. </doc>
  2680. </property>
  2681. <property>
  2682.     <name>QScrollBar::pageStep</name>
  2683.     <doc href="qscrollbar.html#pageStep-prop">
  2684. <p>This property holds the current line step.
  2685. <p>When setting pageStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be called
  2686. if the new page step is different from the previous setting.
  2687. <p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="qscrollbar.html#lineStep-prop">lineStep</a> and <a href="qrangecontrol.html#setRange">setRange</a>().
  2688.  
  2689. <p>Set this property's value with <a href="qscrollbar.html#setPageStep">setPageStep</a>() and get this property's value with <a href="qscrollbar.html#pageStep">pageStep</a>().
  2690. </doc>
  2691. </property>
  2692. <property>
  2693.     <name>QScrollBar::tracking</name>
  2694.     <doc href="qscrollbar.html#tracking-prop">
  2695. <p>This property holds whether scroll bar tracking is enabled.
  2696. <p>If tracking is enabled (the default), the scroll bar emits the
  2697. <a href="qscrollbar.html#valueChanged">valueChanged</a>() signal while the slider is being dragged.  If
  2698. tracking is disabled, the scroll bar emits the valueChanged() signal
  2699. only when the user releases the mouse button after moving the
  2700. slider.
  2701.  
  2702. <p>Set this property's value with <a href="qscrollbar.html#setTracking">setTracking</a>() and get this property's value with <a href="qscrollbar.html#tracking">tracking</a>().
  2703. </doc>
  2704. </property>
  2705. <property>
  2706.     <name>QScrollBar::value</name>
  2707.     <doc href="qscrollbar.html#value-prop">
  2708. <p>This property holds the current scroll bar value.
  2709. <p>Set this property's value with <a href="qscrollbar.html#setValue">setValue</a>() and get this property's value with <a href="qscrollbar.html#value">value</a>().
  2710. <p><p>See also <a href="qrangecontrol.html#value">QRangeControl::value</a>() and <a href="qrangecontrol.html#prevValue">prevValue</a>().
  2711.  
  2712. </doc>
  2713. </property>
  2714. <property>
  2715.     <name>QScrollView::contentsHeight</name>
  2716.     <doc href="qscrollview.html#contentsHeight-prop">
  2717. <p>This property holds the height of the contents area.
  2718. <p>
  2719. <p>Get this property's value with <a href="qscrollview.html#contentsHeight">contentsHeight</a>().
  2720. </doc>
  2721. </property>
  2722. <property>
  2723.     <name>QScrollView::contentsWidth</name>
  2724.     <doc href="qscrollview.html#contentsWidth-prop">
  2725. <p>This property holds the width of the contents area.
  2726. <p>
  2727. <p>Get this property's value with <a href="qscrollview.html#contentsWidth">contentsWidth</a>().
  2728. </doc>
  2729. </property>
  2730. <property>
  2731.     <name>QScrollView::contentsX</name>
  2732.     <doc href="qscrollview.html#contentsX-prop">
  2733. <p>This property holds the X coordinate of the contents that are at the left edge of the viewport.
  2734. <p>
  2735. <p>Get this property's value with <a href="qscrollview.html#contentsX">contentsX</a>().
  2736. </doc>
  2737. </property>
  2738. <property>
  2739.     <name>QScrollView::contentsY</name>
  2740.     <doc href="qscrollview.html#contentsY-prop">
  2741. <p>This property holds the Y coordinate of the contents that are at the top edge of the viewport.
  2742. <p>
  2743. <p>Get this property's value with <a href="qscrollview.html#contentsY">contentsY</a>().
  2744. </doc>
  2745. </property>
  2746. <property>
  2747.     <name>QScrollView::dragAutoScroll</name>
  2748.     <doc href="qscrollview.html#dragAutoScroll-prop">
  2749. <p>This property holds whether autoscrolling in drag move events is enabled.
  2750. <p>If this property is set to TRUE (the default), the QScrollView
  2751. automatically scrolls the contents in drag move events if the user
  2752. moves the cursor close to a border of the view. Of course this works
  2753. only if the viewport accepts drops. Specifying FALSE disables this
  2754. autoscroll feature.
  2755.  
  2756. <p>Set this property's value with <a href="qscrollview.html#setDragAutoScroll">setDragAutoScroll</a>() and get this property's value with <a href="qscrollview.html#dragAutoScroll">dragAutoScroll</a>().
  2757. </doc>
  2758. </property>
  2759. <property>
  2760.     <name>QScrollView::hScrollBarMode</name>
  2761.     <doc href="qscrollview.html#hScrollBarMode-prop">
  2762. <p>This property holds the mode for the horizontal scroll bar.
  2763. <p>The default mode is QScrollView::Auto.
  2764. <p> <p>See also <a href="qscrollview.html#vScrollBarMode-prop">vScrollBarMode</a>.
  2765.  
  2766. <p>Set this property's value with <a href="qscrollview.html#setHScrollBarMode">setHScrollBarMode</a>() and get this property's value with <a href="qscrollview.html#hScrollBarMode">hScrollBarMode</a>().
  2767. </doc>
  2768. </property>
  2769. <property>
  2770.     <name>QScrollView::resizePolicy</name>
  2771.     <doc href="qscrollview.html#resizePolicy-prop">
  2772. <p>This property holds the current resize policy.
  2773. <p>The default is <a href="qscrollview.html#ResizePolicy-enum">Default</a>.
  2774. <p> <p>See also <a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a>.
  2775.  
  2776. <p>Set this property's value with <a href="qscrollview.html#setResizePolicy">setResizePolicy</a>() and get this property's value with <a href="qscrollview.html#resizePolicy">resizePolicy</a>().
  2777. </doc>
  2778. </property>
  2779. <property>
  2780.     <name>QScrollView::vScrollBarMode</name>
  2781.     <doc href="qscrollview.html#vScrollBarMode-prop">
  2782. <p>This property holds the mode for the vertical scroll bar.
  2783. <p>The default mode is QScrollView::Auto.
  2784. <p> <p>See also <a href="qscrollview.html#hScrollBarMode-prop">hScrollBarMode</a>.
  2785.  
  2786. <p>Set this property's value with <a href="qscrollview.html#setVScrollBarMode">setVScrollBarMode</a>() and get this property's value with <a href="qscrollview.html#vScrollBarMode">vScrollBarMode</a>().
  2787. </doc>
  2788. </property>
  2789. <property>
  2790.     <name>QScrollView::visibleHeight</name>
  2791.     <doc href="qscrollview.html#visibleHeight-prop">
  2792. <p>This property holds the vertical amount of the content that is visible.
  2793. <p>
  2794. <p>Get this property's value with <a href="qscrollview.html#visibleHeight">visibleHeight</a>().
  2795. </doc>
  2796. </property>
  2797. <property>
  2798.     <name>QScrollView::visibleWidth</name>
  2799.     <doc href="qscrollview.html#visibleWidth-prop">
  2800. <p>This property holds the horizontal amount of the content that is visible.
  2801. <p>
  2802. <p>Get this property's value with <a href="qscrollview.html#visibleWidth">visibleWidth</a>().
  2803. </doc>
  2804. </property>
  2805. <property>
  2806.     <name>QSlider::lineStep</name>
  2807.     <doc href="qslider.html#lineStep-prop">
  2808. <p>This property holds the current line step.
  2809. <p>When setting lineStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be called
  2810. if the new line step is different from the previous setting.
  2811. <p> <p>See also <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>() and <a href="qrangecontrol.html#setRange">setRange</a>().
  2812.  
  2813. <p>Set this property's value with <a href="qslider.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qslider.html#lineStep">lineStep</a>().
  2814. </doc>
  2815. </property>
  2816. <property>
  2817.     <name>QSlider::maxValue</name>
  2818.     <doc href="qslider.html#maxValue-prop">
  2819. <p>This property holds the current maximum value of the slider.
  2820. <p>When setting this property, the <a href="qslider.html#minValue-prop">QSlider::minValue</a> is adjusted, if
  2821. necessary, to ensure that the range remains valid.
  2822. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
  2823.  
  2824. <p>Set this property's value with <a href="qslider.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qslider.html#maxValue">maxValue</a>().
  2825. </doc>
  2826. </property>
  2827. <property>
  2828.     <name>QSlider::minValue</name>
  2829.     <doc href="qslider.html#minValue-prop">
  2830. <p>This property holds the current minimum value of the slider.
  2831. <p>When setting this property, the <a href="qslider.html#maxValue-prop">QSlider::maxValue</a> is adjusted, if
  2832. necessary, to ensure that the range remains valid.
  2833. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>().
  2834.  
  2835. <p>Set this property's value with <a href="qslider.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qslider.html#minValue">minValue</a>().
  2836. </doc>
  2837. </property>
  2838. <property>
  2839.     <name>QSlider::orientation</name>
  2840.     <doc href="qslider.html#orientation-prop">
  2841. <p>This property holds the orientation of the slider.
  2842. <p>The orientation must be <a href="qt.html#Orientation-enum">Qt::Vertical</a> (the default) or <a href="qt.html#Orientation-enum">Qt::Horizontal</a>.
  2843.  
  2844. <p>Set this property's value with <a href="qslider.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qslider.html#orientation">orientation</a>().
  2845. </doc>
  2846. </property>
  2847. <property>
  2848.     <name>QSlider::pageStep</name>
  2849.     <doc href="qslider.html#pageStep-prop">
  2850. <p>This property holds the current page step.
  2851. <p>When setting pageStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be called
  2852. if the new page step is different from the previous setting.
  2853. <p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="qslider.html#lineStep-prop">lineStep</a> and <a href="qrangecontrol.html#setRange">setRange</a>().
  2854.  
  2855. <p>Set this property's value with <a href="qslider.html#setPageStep">setPageStep</a>() and get this property's value with <a href="qslider.html#pageStep">pageStep</a>().
  2856. </doc>
  2857. </property>
  2858. <property>
  2859.     <name>QSlider::tickInterval</name>
  2860.     <doc href="qslider.html#tickInterval-prop">
  2861. <p>This property holds the interval between tickmarks.
  2862. <p>This is a value interval, not a pixel interval. If it is 0, the slider
  2863. will choose between <a href="qslider.html#lineStep">lineStep</a>() and <a href="qslider.html#pageStep">pageStep</a>(). The initial value of
  2864. tickInterval is 0.
  2865. <p> <p>See also <a href="qrangecontrol.html#lineStep">QRangeControl::lineStep</a>() and <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>().
  2866.  
  2867. <p>Set this property's value with <a href="qslider.html#setTickInterval">setTickInterval</a>() and get this property's value with <a href="qslider.html#tickInterval">tickInterval</a>().
  2868. </doc>
  2869. </property>
  2870. <property>
  2871.     <name>QSlider::tickmarks</name>
  2872.     <doc href="qslider.html#tickmarks-prop">
  2873. <p>This property holds the tickmark settings for this slider.
  2874. <p>The valid values are in <a href="qslider.html#TickSetting-enum">QSlider::TickSetting</a>. The default is
  2875. <a href="qslider.html#TickSetting-enum">NoMarks</a>.
  2876. <p> <p>See also <a href="qslider.html#tickInterval-prop">tickInterval</a>.
  2877.  
  2878. <p>Set this property's value with <a href="qslider.html#setTickmarks">setTickmarks</a>() and get this property's value with <a href="qslider.html#tickmarks">tickmarks</a>().
  2879. </doc>
  2880. </property>
  2881. <property>
  2882.     <name>QSlider::tracking</name>
  2883.     <doc href="qslider.html#tracking-prop">
  2884. <p>This property holds whether slider tracking is enabled.
  2885. <p>If tracking is enabled (the default), the slider emits the
  2886. <a href="qslider.html#valueChanged">valueChanged</a>() signal whenever the slider is being dragged.  If
  2887. tracking is disabled, the slider emits the valueChanged() signal
  2888. when the user releases the mouse button (unless the value happens to
  2889. be the same as before).
  2890.  
  2891. <p>Set this property's value with <a href="qslider.html#setTracking">setTracking</a>() and get this property's value with <a href="qslider.html#tracking">tracking</a>().
  2892. </doc>
  2893. </property>
  2894. <property>
  2895.     <name>QSlider::value</name>
  2896.     <doc href="qslider.html#value-prop">
  2897. <p>This property holds the current slider value.
  2898. <p>Set this property's value with <a href="qslider.html#setValue">setValue</a>() and get this property's value with <a href="qslider.html#value">value</a>().
  2899. <p><p>See also <a href="qrangecontrol.html#value">QRangeControl::value</a>() and <a href="qrangecontrol.html#prevValue">prevValue</a>().
  2900.  
  2901. </doc>
  2902. </property>
  2903. <property>
  2904.     <name>QSpinBox::buttonSymbols</name>
  2905.     <doc href="qspinbox.html#buttonSymbols-prop">
  2906. <p>This property holds the current button symbol mode.
  2907. <p>The possible values can be either <a href="qspinbox.html#ButtonSymbols-enum">UpDownArrows</a> or <a href="qspinbox.html#ButtonSymbols-enum">PlusMinus</a>. The
  2908. default is <a href="qspinbox.html#ButtonSymbols-enum">UpDownArrows</a>.
  2909. <p> <p>See also <a href="qspinbox.html#ButtonSymbols-enum">ButtonSymbols</a>.
  2910.  
  2911. <p>Set this property's value with <a href="qspinbox.html#setButtonSymbols">setButtonSymbols</a>() and get this property's value with <a href="qspinbox.html#buttonSymbols">buttonSymbols</a>().
  2912. </doc>
  2913. </property>
  2914. <property>
  2915.     <name>QSpinBox::cleanText</name>
  2916.     <doc href="qspinbox.html#cleanText-prop">
  2917. <p>This property holds the text of the spin box with any <a href="qspinbox.html#prefix">prefix</a>() or <a href="qspinbox.html#suffix">suffix</a>() and any whitespace at the start and end removed.
  2918. <p>Get this property's value with <a href="qspinbox.html#cleanText">cleanText</a>().
  2919. <p><p>See also <a href="qspinbox.html#text-prop">text</a>, <a href="qspinbox.html#prefix-prop">prefix</a> and <a href="qspinbox.html#suffix-prop">suffix</a>.
  2920.  
  2921. </doc>
  2922. </property>
  2923. <property>
  2924.     <name>QSpinBox::lineStep</name>
  2925.     <doc href="qspinbox.html#lineStep-prop">
  2926. <p>This property holds the line step.
  2927. <p>When the user uses the arrows to change the spin box's value the value
  2928. will be incremented/decremented by the amount of the line step.
  2929. <p> The <a href="qspinbox.html#setLineStep">setLineStep</a>() function calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function
  2930. if the new line step is different from the previous setting.
  2931. <p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>() and <a href="qrangecontrol.html#setRange">setRange</a>().
  2932.  
  2933. <p>Set this property's value with <a href="qspinbox.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qspinbox.html#lineStep">lineStep</a>().
  2934. </doc>
  2935. </property>
  2936. <property>
  2937.     <name>QSpinBox::maxValue</name>
  2938.     <doc href="qspinbox.html#maxValue-prop">
  2939. <p>This property holds the maximum value of the spin box.
  2940. <p>When setting this property, the <a href="qspinbox.html#minValue-prop">QSpinBox::minValue</a> is adjusted so
  2941. that the range remains valid if necessary.
  2942. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="qspinbox.html#specialValueText-prop">specialValueText</a>.
  2943.  
  2944. <p>Set this property's value with <a href="qspinbox.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qspinbox.html#maxValue">maxValue</a>().
  2945. </doc>
  2946. </property>
  2947. <property>
  2948.     <name>QSpinBox::minValue</name>
  2949.     <doc href="qspinbox.html#minValue-prop">
  2950. <p>This property holds the minimum value of the spin box.
  2951. <p>When setting this property, the <a href="qspinbox.html#maxValue-prop">QSpinBox::maxValue</a> is adjusted so
  2952. that the range remains valid if necessary.
  2953. <p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="qspinbox.html#specialValueText-prop">specialValueText</a>.
  2954.  
  2955. <p>Set this property's value with <a href="qspinbox.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qspinbox.html#minValue">minValue</a>().
  2956. </doc>
  2957. </property>
  2958. <property>
  2959.     <name>QSpinBox::prefix</name>
  2960.     <doc href="qspinbox.html#prefix-prop">
  2961. <p>This property holds the prefix of the spin box.
  2962. <p>The prefix is prepended to the start of the displayed value. Typical use is
  2963. to indicate the unit of measurement to the user. For example:
  2964. <p> <pre>
  2965.     sb-&gt;setPrefix( "$" );
  2966.   </pre>
  2967.  
  2968. <p> To turn off the prefix display, set this property to an empty
  2969. string. The default is no prefix. The prefix is not displayed for
  2970. the <a href="qspinbox.html#minValue">minValue</a>() if <a href="qspinbox.html#specialValueText">specialValueText</a>() is not empty.
  2971. <p> If no prefix is set, <a href="qspinbox.html#prefix">prefix</a>() returns a null string.
  2972. <p> <p>See also <a href="qspinbox.html#suffix-prop">suffix</a>.
  2973.  
  2974. <p>Set this property's value with <a href="qspinbox.html#setPrefix">setPrefix</a>() and get this property's value with <a href="qspinbox.html#prefix">prefix</a>().
  2975. </doc>
  2976. </property>
  2977. <property>
  2978.     <name>QSpinBox::specialValueText</name>
  2979.     <doc href="qspinbox.html#specialValueText-prop">
  2980. <p>This property holds the special-value text.
  2981. <p>If set, the spin box will display this text instead of a numeric value
  2982. whenever the current value is equal to minVal(). Typical use is to indicate
  2983. that this choice has a special (default) meaning.
  2984. <p> For example, if your spin box allows the user to choose the
  2985. margin width in a print dialog and your application is able to
  2986. automatically choose a good margin width, you can set up the spin
  2987. box like this:
  2988. <pre>
  2989.     QSpinBox marginBox( -1, 20, 1, parent, "marginBox" );
  2990.     marginBox-&gt;<a href="qspinbox.html#setSuffix">setSuffix</a>( " mm" );
  2991.     marginBox-&gt;<a href="qspinbox.html#setSpecialValueText">setSpecialValueText</a>( "Auto" );
  2992.   </pre>
  2993.  
  2994. The user will then be able to choose a margin width from 0-20
  2995. millimeters or select "Auto" to leave it to the application to
  2996. choose.  Your code must then interpret the spin box value of -1 as
  2997. the user requesting automatic margin width.
  2998. <p> All values are displayed with the <a href="qspinbox.html#prefix">prefix</a>() and <a href="qspinbox.html#suffix">suffix</a>() (if set), <em>except</em> for the special value, which only shows the special value text.
  2999. <p> To turn off the special-value text display, call this function with
  3000. an empty string. The default is no special-value text, i.e. the
  3001. numeric value is shown as usual.
  3002. <p> If no special-value text is set, <a href="qspinbox.html#specialValueText">specialValueText</a>() returns a null
  3003. string.
  3004.  
  3005. <p>Set this property's value with <a href="qspinbox.html#setSpecialValueText">setSpecialValueText</a>() and get this property's value with <a href="qspinbox.html#specialValueText">specialValueText</a>().
  3006. </doc>
  3007. </property>
  3008. <property>
  3009.     <name>QSpinBox::suffix</name>
  3010.     <doc href="qspinbox.html#suffix-prop">
  3011. <p>This property holds the suffix of the spin box.
  3012. <p>The suffix is appended to the end of the displayed value.  Typical
  3013. use is to indicate the unit of measurement to the user. For example:
  3014. <p> <pre>
  3015.     sb-&gt;setSuffix( " km" );
  3016.   </pre>
  3017.  
  3018. <p> To turn off the suffix display, set this property to an empty
  3019. string. The default is no suffix. The suffix is not displayed for
  3020. the <a href="qspinbox.html#minValue">minValue</a>() if <a href="qspinbox.html#specialValueText">specialValueText</a>() is not empty.
  3021. <p> If no suffix is set, <a href="qspinbox.html#suffix">suffix</a>() returns a null string.
  3022. <p> <p>See also <a href="qspinbox.html#prefix-prop">prefix</a>.
  3023.  
  3024. <p>Set this property's value with <a href="qspinbox.html#setSuffix">setSuffix</a>() and get this property's value with <a href="qspinbox.html#suffix">suffix</a>().
  3025. </doc>
  3026. </property>
  3027. <property>
  3028.     <name>QSpinBox::text</name>
  3029.     <doc href="qspinbox.html#text-prop">
  3030. <p>This property holds the text of the spin box, including any <a href="qspinbox.html#prefix">prefix</a>() and <a href="qspinbox.html#suffix">suffix</a>().
  3031. <p>There is no default text.
  3032. <p> <p>See also <a href="qspinbox.html#value-prop">value</a>.
  3033.  
  3034. <p>Get this property's value with <a href="qspinbox.html#text">text</a>().
  3035. </doc>
  3036. </property>
  3037. <property>
  3038.     <name>QSpinBox::value</name>
  3039.     <doc href="qspinbox.html#value-prop">
  3040. <p>This property holds the value of the spin box.
  3041. <p>Set this property's value with <a href="qspinbox.html#setValue">setValue</a>() and get this property's value with <a href="qspinbox.html#value">value</a>().
  3042. <p><p>See also <a href="qrangecontrol.html#setValue">QRangeControl::setValue</a>().
  3043.  
  3044. </doc>
  3045. </property>
  3046. <property>
  3047.     <name>QSpinBox::wrapping</name>
  3048.     <doc href="qspinbox.html#wrapping-prop">
  3049. <p>This property holds whether it is possible to step the value from the highest value to the lowest value and vice versa.
  3050. <p>By default, wrapping is turned off.
  3051. <p> If you have a range of 0..100 and wrapping is off when the user
  3052. reaches 100 and presses the Up Arrow nothing will happen; but if
  3053. wrapping is on the value will change from 100 to 0, then to 1, etc.
  3054. When wrapping is on, navigating past the highest value takes you to
  3055. the lowest and vice versa.
  3056. <p> <p>See also <a href="qspinbox.html#minValue-prop">minValue</a>, <a href="qspinbox.html#maxValue-prop">maxValue</a> and <a href="qrangecontrol.html#setRange">setRange</a>().
  3057.  
  3058. <p>Set this property's value with <a href="qspinbox.html#setWrapping">setWrapping</a>() and get this property's value with <a href="qspinbox.html#wrapping">wrapping</a>().
  3059. </doc>
  3060. </property>
  3061. <property>
  3062.     <name>QSplitter::orientation</name>
  3063.     <doc href="qsplitter.html#orientation-prop">
  3064. <p>This property holds the orientation of the splitter.
  3065. <p>By default the orientation is horizontal (the widgets are side by side).
  3066. The possible orientations are Qt:Vertical and Qt::Horizontal (the default).
  3067. <p> 
  3068. <p>Set this property's value with <a href="qsplitter.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qsplitter.html#orientation">orientation</a>().
  3069. </doc>
  3070. </property>
  3071. <property>
  3072.     <name>QSqlDatabase::databaseName</name>
  3073.     <doc href="qsqldatabase.html#databaseName-prop"> <p>This property holds the name of the database or the TNS Service Name for the QOCI8 (Oracle) driver.
  3074. <p>There is no default value.
  3075.  
  3076. <p>Set this property's value with <a href="qsqldatabase.html#setDatabaseName">setDatabaseName</a>() and get this property's value with <a href="qsqldatabase.html#databaseName">databaseName</a>().
  3077. </doc>
  3078. </property>
  3079. <property>
  3080.     <name>QSqlDatabase::hostName</name>
  3081.     <doc href="qsqldatabase.html#hostName-prop"> <p>This property holds the host name where the database resides.
  3082. <p>There is no default value.
  3083. <p> 
  3084. <p>Set this property's value with <a href="qsqldatabase.html#setHostName">setHostName</a>() and get this property's value with <a href="qsqldatabase.html#hostName">hostName</a>().
  3085. </doc>
  3086. </property>
  3087. <property>
  3088.     <name>QSqlDatabase::password</name>
  3089.     <doc href="qsqldatabase.html#password-prop"> <p>This property holds the password used to connect to the database.
  3090. <p>There is no default value.
  3091. <p> 
  3092. <p>Set this property's value with <a href="qsqldatabase.html#setPassword">setPassword</a>() and get this property's value with <a href="qsqldatabase.html#password">password</a>().
  3093. </doc>
  3094. </property>
  3095. <property>
  3096.     <name>QSqlDatabase::port</name>
  3097.     <doc href="qsqldatabase.html#port-prop"> <p>This property holds the port used to connect to the database.
  3098. <p>There is no default value.
  3099. <p> 
  3100. <p>Set this property's value with <a href="qsqldatabase.html#setPort">setPort</a>() and get this property's value with <a href="qsqldatabase.html#port">port</a>().
  3101. </doc>
  3102. </property>
  3103. <property>
  3104.     <name>QSqlDatabase::userName</name>
  3105.     <doc href="qsqldatabase.html#userName-prop"> <p>This property holds the user name connected to the database.
  3106. <p>There is no default value.
  3107. <p> 
  3108. <p>Set this property's value with <a href="qsqldatabase.html#setUserName">setUserName</a>() and get this property's value with <a href="qsqldatabase.html#userName">userName</a>().
  3109. </doc>
  3110. </property>
  3111. <property>
  3112.     <name>QStatusBar::sizeGripEnabled</name>
  3113.     <doc href="qstatusbar.html#sizeGripEnabled-prop">
  3114. <p>This property holds whether the <a href="qsizegrip.html">QSizeGrip</a> in the bottom right of the status bar is enabled.
  3115. <p>Enables or disables the QSizeGrip in the bottom right of the status bar.
  3116. By default, the size grip is enabled.
  3117.  
  3118. <p>Set this property's value with <a href="qstatusbar.html#setSizeGripEnabled">setSizeGripEnabled</a>() and get this property's value with <a href="qstatusbar.html#isSizeGripEnabled">isSizeGripEnabled</a>().
  3119. </doc>
  3120. </property>
  3121. <property>
  3122.     <name>QTabBar::count</name>
  3123.     <doc href="qtabbar.html#count-prop"> <p>This property holds the number of tabs in the tab bar.
  3124. <p>Get this property's value with <a href="qtabbar.html#count">count</a>().
  3125. <p><p>See also <a href="qtabbar.html#tab">tab</a>().
  3126.  
  3127. </doc>
  3128. </property>
  3129. <property>
  3130.     <name>QTabBar::currentTab</name>
  3131.     <doc href="qtabbar.html#currentTab-prop"> <p>This property holds the id of the currently visible tab in the tab bar.
  3132. <p>If no tab page is currently visible, -1 will be the current value
  3133. for this property.
  3134. Even if the property value is not -1, you cannot assume that
  3135. the user can see the relevant page, or that the tab is enabled.
  3136. When you need to display something the value of this property
  3137. represents the best page to display.
  3138. <p> When this property is set to <em>id</em>, it will raise the tab with the
  3139. id <em>id</em> and emit the <a href="qtabbar.html#selected">selected</a>() signal.
  3140. <p> <p>See also <a href="qtabbar.html#selected">selected</a>() and <a href="qtabbar.html#isTabEnabled">isTabEnabled</a>().
  3141.  
  3142. <p>Set this property's value with <a href="qtabbar.html#setCurrentTab">setCurrentTab</a>() and get this property's value with <a href="qtabbar.html#currentTab">currentTab</a>().
  3143. </doc>
  3144. </property>
  3145. <property>
  3146.     <name>QTabBar::keyboardFocusTab</name>
  3147.     <doc href="qtabbar.html#keyboardFocusTab-prop"> <p>This property holds the id of the tab that currently has the keyboard focus.
  3148. <p>This property contains the id of the tab that currently has the
  3149. keyboard focus. If the tab bar does not have keyboard focus, the
  3150. value of this property will be -1.
  3151. <p> 
  3152. <p>Get this property's value with <a href="qtabbar.html#keyboardFocusTab">keyboardFocusTab</a>().
  3153. </doc>
  3154. </property>
  3155. <property>
  3156.     <name>QTabBar::shape</name>
  3157.     <doc href="qtabbar.html#shape-prop"> <p>This property holds the shape of the tabs in the tab bar.
  3158. <p>The value of this property can be one of the following:
  3159. <a href="qtabbar.html#Shape-enum">RoundedAbove</a> (default), <a href="qtabbar.html#Shape-enum">RoundedBelow</a>, <a href="qtabbar.html#Shape-enum">TriangularAbove</a> or <a href="qtabbar.html#Shape-enum">TriangularBelow</a>.
  3160. <p> <p>See also <a href="qtabbar.html#Shape-enum">Shape</a>.
  3161.  
  3162. <p>Set this property's value with <a href="qtabbar.html#setShape">setShape</a>() and get this property's value with <a href="qtabbar.html#shape">shape</a>().
  3163. </doc>
  3164. </property>
  3165. <property>
  3166.     <name>QTabWidget::count</name>
  3167.     <doc href="qtabwidget.html#count-prop"> <p>This property holds the number of tabs in the tab bar.
  3168. <p>
  3169. <p>Get this property's value with <a href="qtabwidget.html#count">count</a>().
  3170. </doc>
  3171. </property>
  3172. <property>
  3173.     <name>QTabWidget::currentPage</name>
  3174.     <doc href="qtabwidget.html#currentPage-prop"> <p>This property holds the index position of the current tab page.
  3175. <p>Set this property's value with <a href="qtabwidget.html#setCurrentPage">setCurrentPage</a>() and get this property's value with <a href="qtabwidget.html#currentPageIndex">currentPageIndex</a>().
  3176. <p><p>See also <a href="qtabbar.html#currentTab-prop">QTabBar::currentTab</a>.
  3177.  
  3178. </doc>
  3179. </property>
  3180. <property>
  3181.     <name>QTabWidget::margin</name>
  3182.     <doc href="qtabwidget.html#margin-prop"> <p>This property holds the margin in this tab widget.
  3183. <p>The margin is the distance between the innermost pixel of the frame
  3184. and the outermost pixel of the pages.
  3185.  
  3186. <p>Set this property's value with <a href="qtabwidget.html#setMargin">setMargin</a>() and get this property's value with <a href="qtabwidget.html#margin">margin</a>().
  3187. </doc>
  3188. </property>
  3189. <property>
  3190.     <name>QTabWidget::tabPosition</name>
  3191.     <doc href="qtabwidget.html#tabPosition-prop"> <p>This property holds the position of the tabs in this tab widget.
  3192. <p>Possible values for this property are QTabWidget::Top and
  3193. QTabWidget::Bottom.
  3194. <p> <p>See also <a href="qtabwidget.html#TabPosition-enum">TabPosition</a>.
  3195.  
  3196. <p>Set this property's value with <a href="qtabwidget.html#setTabPosition">setTabPosition</a>() and get this property's value with <a href="qtabwidget.html#tabPosition">tabPosition</a>().
  3197. </doc>
  3198. </property>
  3199. <property>
  3200.     <name>QTabWidget::tabShape</name>
  3201.     <doc href="qtabwidget.html#tabShape-prop"> <p>This property holds the shape of the tabs in this tab widget.
  3202. <p>Possible values for this property are QTabWidget::Rounded (default) or
  3203. QTabWidget::Triangular.
  3204. <p> <p>See also <a href="qtabwidget.html#TabShape-enum">TabShape</a>.
  3205.  
  3206. <p>Set this property's value with <a href="qtabwidget.html#setTabShape">setTabShape</a>() and get this property's value with <a href="qtabwidget.html#tabShape">tabShape</a>().
  3207. </doc>
  3208. </property>
  3209. <property>
  3210.     <name>QTable::columnMovingEnabled</name>
  3211.     <doc href="qtable.html#columnMovingEnabled-prop"> <p>This property holds whether columns can be moved by the user.
  3212. <p>The default is FALSE.
  3213. <p> <p>See also <a href="qtable.html#rowMovingEnabled-prop">rowMovingEnabled</a>.
  3214.  
  3215. <p>Set this property's value with <a href="qtable.html#setColumnMovingEnabled">setColumnMovingEnabled</a>() and get this property's value with <a href="qtable.html#columnMovingEnabled">columnMovingEnabled</a>().
  3216. </doc>
  3217. </property>
  3218. <property>
  3219.     <name>QTable::focusStyle</name>
  3220.     <doc href="qtable.html#focusStyle-prop"> <p>This property holds how the current (focus) cell is drawn.
  3221. <p>The default style is <a href="qtable.html#FocusStyle-enum">SpreadSheet</a>.
  3222. <p> <p>See also <a href="qtable.html#FocusStyle-enum">QTable::FocusStyle</a>.
  3223.  
  3224. <p>Set this property's value with <a href="qtable.html#setFocusStyle">setFocusStyle</a>() and get this property's value with <a href="qtable.html#focusStyle">focusStyle</a>().
  3225. </doc>
  3226. </property>
  3227. <property>
  3228.     <name>QTable::numCols</name>
  3229.     <doc href="qtable.html#numCols-prop"> <p>This property holds the number of columns in the table.
  3230. <p>Set this property's value with <a href="qtable.html#setNumCols">setNumCols</a>() and get this property's value with <a href="qtable.html#numCols">numCols</a>().
  3231. <p><p>See also <a href="qtable.html#numRows-prop">numRows</a>.
  3232.  
  3233. </doc>
  3234. </property>
  3235. <property>
  3236.     <name>QTable::numRows</name>
  3237.     <doc href="qtable.html#numRows-prop"> <p>This property holds the number of rows in the table.
  3238. <p>Set this property's value with <a href="qtable.html#setNumRows">setNumRows</a>() and get this property's value with <a href="qtable.html#numRows">numRows</a>().
  3239. <p><p>See also <a href="qtable.html#numCols-prop">numCols</a>.
  3240.  
  3241. </doc>
  3242. </property>
  3243. <property>
  3244.     <name>QTable::readOnly</name>
  3245.     <doc href="qtable.html#readOnly-prop"> <p>This property holds whether the table is read-only.
  3246. <p>Whether a cell in the table is editable or read-only depends on the
  3247. cell's EditType, and this setting:
  3248. see <a href="qtableitem.html#wheneditable">QTableItem::EditType</a>.
  3249. <p> <p>See also <a href="qwidget.html#enabled-prop">QWidget::enabled</a>, <a href="qtable.html#setColumnReadOnly">setColumnReadOnly</a>() and <a href="qtable.html#setRowReadOnly">setRowReadOnly</a>().
  3250.  
  3251. <p>Set this property's value with <a href="qtable.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qtable.html#isReadOnly">isReadOnly</a>().
  3252. </doc>
  3253. </property>
  3254. <property>
  3255.     <name>QTable::rowMovingEnabled</name>
  3256.     <doc href="qtable.html#rowMovingEnabled-prop"> <p>This property holds whether rows can be moved by the user.
  3257. <p>The default is FALSE.
  3258. <p> <p>See also <a href="qtable.html#columnMovingEnabled-prop">columnMovingEnabled</a>.
  3259.  
  3260. <p>Set this property's value with <a href="qtable.html#setRowMovingEnabled">setRowMovingEnabled</a>() and get this property's value with <a href="qtable.html#rowMovingEnabled">rowMovingEnabled</a>().
  3261. </doc>
  3262. </property>
  3263. <property>
  3264.     <name>QTable::selectionMode</name>
  3265.     <doc href="qtable.html#selectionMode-prop"> <p>This property holds the current selection mode.
  3266. <p>The default mode is <a href="qtable.html#SelectionMode-enum">Multi</a> which allows the user to select multiple
  3267. ranges of cells.
  3268. <p> <p>See also <a href="qtable.html#SelectionMode-enum">SelectionMode</a> and <a href="qtable.html#selectionMode-prop">selectionMode</a>.
  3269.  
  3270. <p>Set this property's value with <a href="qtable.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qtable.html#selectionMode">selectionMode</a>().
  3271. </doc>
  3272. </property>
  3273. <property>
  3274.     <name>QTable::showGrid</name>
  3275.     <doc href="qtable.html#showGrid-prop"> <p>This property holds whether the table's grid is displayed.
  3276. <p>The grid is shown by default.
  3277.  
  3278. <p>Set this property's value with <a href="qtable.html#setShowGrid">setShowGrid</a>() and get this property's value with <a href="qtable.html#showGrid">showGrid</a>().
  3279. </doc>
  3280. </property>
  3281. <property>
  3282.     <name>QTable::sorting</name>
  3283.     <doc href="qtable.html#sorting-prop"> <p>This property holds whether a click on the header of a column sorts that column.
  3284. <p>Set this property's value with <a href="qtable.html#setSorting">setSorting</a>() and get this property's value with <a href="qtable.html#sorting">sorting</a>().
  3285. <p><p>See also <a href="qtable.html#sortColumn">sortColumn</a>().
  3286.  
  3287. </doc>
  3288. </property>
  3289. <property>
  3290.     <name>QTextBrowser::source</name>
  3291.     <doc href="qtextbrowser.html#source-prop">
  3292. <p>This property holds the name of the currently displayed document.
  3293. <p>This is a null string if no document is displayed or
  3294. the source is unknown.
  3295. <p> Setting this property uses the mimeSourceFactory to lookup the
  3296. named document. It also checks for optional anchors and scrolls the
  3297. document accordingly.
  3298. <p> If the first tag in the document is <tt>&lt;qt type=detail&gt;</tt>, the document
  3299. is displayed as a popup rather than as new document in the browser
  3300. window itself. Otherwise, the document is displayed normally in the
  3301. text browser with the text set to the contents of the named document
  3302. with <a href="qtextedit.html#setText">setText</a>().
  3303. <p> If you are using the filesystem access capabilities of the mime
  3304. source factory, you must ensure that the factory knows about the
  3305. encoding of specified files; otherwise no data will be
  3306. available. The default factory handles a couple of common file
  3307. extensions such as <tt>*.html</tt> and <tt>*.txt</tt> with reasonable defaults. See
  3308. <a href="qmimesourcefactory.html#data">QMimeSourceFactory::data</a>() for details.
  3309.  
  3310. <p>Set this property's value with <a href="qtextbrowser.html#setSource">setSource</a>() and get this property's value with <a href="qtextbrowser.html#source">source</a>().
  3311. </doc>
  3312. </property>
  3313. <property>
  3314.     <name>QTextEdit::documentTitle</name>
  3315.     <doc href="qtextedit.html#documentTitle-prop">
  3316. <p>This property holds the title of the document parsed from the text.
  3317. <p>For <a href="qt.html#TextFormat-enum">PlainText</a> the title will be an empty string. For <a href="qt.html#TextFormat-enum">RichText</a>
  3318. the title will be the text between the <tt>&lt;title&gt;</tt> tags, if present,
  3319. otherwise an empty string.
  3320.  
  3321. <p>Get this property's value with <a href="qtextedit.html#documentTitle">documentTitle</a>().
  3322. </doc>
  3323. </property>
  3324. <property>
  3325.     <name>QTextEdit::hasSelectedText</name>
  3326.     <doc href="qtextedit.html#hasSelectedText-prop"> <p>This property holds whether some text is selected in selection 0.
  3327. <p>
  3328. <p>Get this property's value with <a href="qtextedit.html#hasSelectedText">hasSelectedText</a>().
  3329. </doc>
  3330. </property>
  3331. <property>
  3332.     <name>QTextEdit::length</name>
  3333.     <doc href="qtextedit.html#length-prop">
  3334. <p>This property holds the number of characters in the text.
  3335. <p>
  3336. <p>Get this property's value with <a href="qtextedit.html#length">length</a>().
  3337. </doc>
  3338. </property>
  3339. <property>
  3340.     <name>QTextEdit::linkUnderline</name>
  3341.     <doc href="qtextedit.html#linkUnderline-prop">
  3342. <p>This property holds whether hypertext links will be underlined.
  3343. <p>If TRUE (the default) hypertext links will be displayed underlined.
  3344. If FALSE links will not be displayed underlined.
  3345.  
  3346. <p>Set this property's value with <a href="qtextedit.html#setLinkUnderline">setLinkUnderline</a>() and get this property's value with <a href="qtextedit.html#linkUnderline">linkUnderline</a>().
  3347. </doc>
  3348. </property>
  3349. <property>
  3350.     <name>QTextEdit::modified</name>
  3351.     <doc href="qtextedit.html#modified-prop"> <p>This property holds whether the document has been modified by the user.
  3352. <p>
  3353. <p>Set this property's value with <a href="qtextedit.html#setModified">setModified</a>() and get this property's value with <a href="qtextedit.html#isModified">isModified</a>().
  3354. </doc>
  3355. </property>
  3356. <property>
  3357.     <name>QTextEdit::overwriteMode</name>
  3358.     <doc href="qtextedit.html#overwriteMode-prop">
  3359. <p>This property holds the text edit's overwrite mode.
  3360. <p>If FALSE (the default) characters entered by the user are inserted
  3361. with any characters to the right being moved out of the way.
  3362. If TRUE, the editor is in overwrite mode, i.e. characters entered by
  3363. the user overwrite any characters to the right of the cursor position.
  3364.  
  3365. <p>Set this property's value with <a href="qtextedit.html#setOverwriteMode">setOverwriteMode</a>() and get this property's value with <a href="qtextedit.html#isOverwriteMode">isOverwriteMode</a>().
  3366. </doc>
  3367. </property>
  3368. <property>
  3369.     <name>QTextEdit::paper</name>
  3370.     <doc href="qtextedit.html#paper-prop">
  3371. <p>This property holds the background (paper) brush.
  3372. <p>The brush that is currently used to draw the background of the
  3373. text edit. The initial setting is an empty brush.
  3374.  
  3375. <p>Set this property's value with <a href="qtextedit.html#setPaper">setPaper</a>() and get this property's value with <a href="qtextedit.html#paper">paper</a>().
  3376. </doc>
  3377. </property>
  3378. <property>
  3379.     <name>QTextEdit::readOnly</name>
  3380.     <doc href="qtextedit.html#readOnly-prop">
  3381. <p>This property holds whether the text edit is read-only.
  3382. <p>In a read-only text edit the user can only navigate through the text
  3383. and select text; modifying the text is not possible.
  3384. <p> This property's default is FALSE.
  3385.  
  3386. <p>Set this property's value with <a href="qtextedit.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qtextedit.html#isReadOnly">isReadOnly</a>().
  3387. </doc>
  3388. </property>
  3389. <property>
  3390.     <name>QTextEdit::selectedText</name>
  3391.     <doc href="qtextedit.html#selectedText-prop"><p>This property holds the selected text (from selection 0) or an empty string if there is no currently selected text (in selection 0).
  3392. <p>The text is always returned as <a href="qt.html#TextFormat-enum">PlainText</a> regardless of the text
  3393. format. In a future version of Qt an HTML subset <em>may</em> be returned
  3394. depending on the text format.
  3395. <p> <p>See also <a href="qtextedit.html#hasSelectedText-prop">hasSelectedText</a>.
  3396.  
  3397. <p>Get this property's value with <a href="qtextedit.html#selectedText">selectedText</a>().
  3398. </doc>
  3399. </property>
  3400. <property>
  3401.     <name>QTextEdit::tabStopWidth</name>
  3402.     <doc href="qtextedit.html#tabStopWidth-prop">
  3403. <p>This property holds the tab stop width in pixels.
  3404. <p>
  3405. <p>Set this property's value with <a href="qtextedit.html#setTabStopWidth">setTabStopWidth</a>() and get this property's value with <a href="qtextedit.html#tabStopWidth">tabStopWidth</a>().
  3406. </doc>
  3407. </property>
  3408. <property>
  3409.     <name>QTextEdit::text</name>
  3410.     <doc href="qtextedit.html#text-prop">
  3411. <p>This property holds the text edit's text.
  3412. <p>There is no default text.
  3413. <p> On setting, any previous text is deleted.
  3414. <p> The text may be interpreted either as plain text or as rich text,
  3415. depending on the <a href="qtextedit.html#textFormat">textFormat</a>(). The default setting is <a href="qt.html#TextFormat-enum">AutoText</a>,
  3416. i.e. the text edit autodetects the format of the text.
  3417. <p> For richtext, calling <a href="qtextedit.html#text">text</a>() on an editable QTextEdit will cause the text
  3418. to be regenerated from the textedit.  This may mean that the <a href="qstring.html">QString</a> returned
  3419. may not be exactly the same as the one that was set.
  3420. <p> <p>See also <a href="qtextedit.html#textFormat-prop">textFormat</a>.
  3421.  
  3422. <p>Set this property's value with <a href="qtextedit.html#setText">setText</a>() and get this property's value with <a href="qtextedit.html#text">text</a>().
  3423. </doc>
  3424. </property>
  3425. <property>
  3426.     <name>QTextEdit::textFormat</name>
  3427.     <doc href="qtextedit.html#textFormat-prop">
  3428. <p>This property holds the text format: rich text, plain text or auto text.
  3429. <p>The text format is one of the following:
  3430. <ul>
  3431. <li> PlainText - all characters, except newlines, are displayed
  3432. verbatim, including spaces. Whenever a newline appears in the text the
  3433. text edit inserts a hard line break and begins a new paragraph.
  3434. <li> RichText - rich text rendering. The available styles are
  3435. defined in the default stylesheet <a href="qstylesheet.html#defaultSheet">QStyleSheet::defaultSheet</a>().
  3436. <li> AutoText - this is the default. The text edit autodetects
  3437. which rendering style is best, <a href="qt.html#TextFormat-enum">PlainText</a> or <a href="qt.html#TextFormat-enum">RichText</a>. This is
  3438. done by using the <a href="qstylesheet.html#mightBeRichText">QStyleSheet::mightBeRichText</a>() function.
  3439. </ul>
  3440.  
  3441. <p>Set this property's value with <a href="qtextedit.html#setTextFormat">setTextFormat</a>() and get this property's value with <a href="qtextedit.html#textFormat">textFormat</a>().
  3442. </doc>
  3443. </property>
  3444. <property>
  3445.     <name>QTextEdit::undoDepth</name>
  3446.     <doc href="qtextedit.html#undoDepth-prop">
  3447. <p>This property holds the depth of the undo history.
  3448. <p>The maximum number of steps in the undo/redo history.
  3449. The default is 100.
  3450. <p> <p>See also <a href="qtextedit.html#undo">undo</a>() and <a href="qtextedit.html#redo">redo</a>().
  3451.  
  3452. <p>Set this property's value with <a href="qtextedit.html#setUndoDepth">setUndoDepth</a>() and get this property's value with <a href="qtextedit.html#undoDepth">undoDepth</a>().
  3453. </doc>
  3454. </property>
  3455. <property>
  3456.     <name>QTextEdit::undoRedoEnabled</name>
  3457.     <doc href="qtextedit.html#undoRedoEnabled-prop"> <p>This property holds whether undo/redo is enabled.
  3458. <p>The default is TRUE.
  3459.  
  3460. <p>Set this property's value with <a href="qtextedit.html#setUndoRedoEnabled">setUndoRedoEnabled</a>() and get this property's value with <a href="qtextedit.html#isUndoRedoEnabled">isUndoRedoEnabled</a>().
  3461. </doc>
  3462. </property>
  3463. <property>
  3464.     <name>QTextEdit::wordWrap</name>
  3465.     <doc href="qtextedit.html#wordWrap-prop">
  3466. <p>This property holds the word wrap mode.
  3467. <p>The default mode is <a href="qtextedit.html#WordWrap-enum">WidgetWidth</a> which causes words to be wrapped
  3468. at the right edge of the text edit. Wrapping occurs at whitespace,
  3469. keeping whole words intact. If you want wrapping to occur within
  3470. words use <a href="qtextedit.html#setWrapPolicy">setWrapPolicy</a>(). If you set a wrap mode of <a href="qtextedit.html#WordWrap-enum">FixedPixelWidth</a> or <a href="qtextedit.html#WordWrap-enum">FixedColumnWidth</a> you should also call
  3471. <a href="qtextedit.html#setWrapColumnOrWidth">setWrapColumnOrWidth</a>() with the width you want.
  3472. <p> <p>See also <a href="qtextedit.html#WordWrap-enum">WordWrap</a>, <a href="qtextedit.html#wrapColumnOrWidth-prop">wrapColumnOrWidth</a> and <a href="qtextedit.html#wrapPolicy-prop">wrapPolicy</a>.
  3473.  
  3474. <p>Set this property's value with <a href="qtextedit.html#setWordWrap">setWordWrap</a>() and get this property's value with <a href="qtextedit.html#wordWrap">wordWrap</a>().
  3475. </doc>
  3476. </property>
  3477. <property>
  3478.     <name>QTextEdit::wrapColumnOrWidth</name>
  3479.     <doc href="qtextedit.html#wrapColumnOrWidth-prop">
  3480. <p>This property holds the position (in pixels or columns depending on the wrap mode) where text will be wrapped.
  3481. <p>If the wrap mode is <a href="qtextedit.html#WordWrap-enum">FixedPixelWidth</a>, the value is the number
  3482. of pixels from the left edge of the text edit at which text should
  3483. be wrapped. If the wrap mode is <a href="qtextedit.html#WordWrap-enum">FixedColumnWidth</a>, the value is
  3484. the column number (in character columns) from the left edge of the
  3485. text edit at which text should be wrapped.
  3486. <p> <p>See also <a href="qtextedit.html#wordWrap-prop">wordWrap</a>.
  3487.  
  3488. <p>Set this property's value with <a href="qtextedit.html#setWrapColumnOrWidth">setWrapColumnOrWidth</a>() and get this property's value with <a href="qtextedit.html#wrapColumnOrWidth">wrapColumnOrWidth</a>().
  3489. </doc>
  3490. </property>
  3491. <property>
  3492.     <name>QTextEdit::wrapPolicy</name>
  3493.     <doc href="qtextedit.html#wrapPolicy-prop">
  3494. <p>This property holds the word wrap policy, at whitespace or anywhere.
  3495. <p>Defines where text can be wrapped when word wrap mode is not
  3496. <a href="qtextedit.html#WordWrap-enum">NoWrap</a>. The choices are <a href="qtextedit.html#WrapPolicy-enum">AtWhiteSpace</a> (the default) and <a href="qtextedit.html#WrapPolicy-enum">Anywhere</a>.
  3497. <p> <p>See also <a href="qtextedit.html#wordWrap-prop">wordWrap</a>.
  3498.  
  3499. <p>Set this property's value with <a href="qtextedit.html#setWrapPolicy">setWrapPolicy</a>() and get this property's value with <a href="qtextedit.html#wrapPolicy">wrapPolicy</a>().
  3500. </doc>
  3501. </property>
  3502. <property>
  3503.     <name>QTimeEdit::autoAdvance</name>
  3504.     <doc href="qtimeedit.html#autoAdvance-prop"> <p>This property holds whether the editor automatically advances to the next section.
  3505. <p>If autoAdvance is TRUE, the editor will automatically advance focus
  3506. to the next time section if a user has completed a section. The
  3507. default is FALSE.
  3508. <p> 
  3509. <p>Set this property's value with <a href="qtimeedit.html#setAutoAdvance">setAutoAdvance</a>() and get this property's value with <a href="qtimeedit.html#autoAdvance">autoAdvance</a>().
  3510. </doc>
  3511. </property>
  3512. <property>
  3513.     <name>QTimeEdit::maxValue</name>
  3514.     <doc href="qtimeedit.html#maxValue-prop"> <p>This property holds the maximum time value.
  3515. <p>Setting the maximum time value is equivalent to calling
  3516. <a href="qtimeedit.html#setRange">QTimeEdit::setRange</a>( <a href="qtimeedit.html#minValue">minValue</a>(), <em>t</em> ), where <em>t</em> is the
  3517. maximum time. The default maximum time is 23:59:59.
  3518.  
  3519. <p>Set this property's value with <a href="qtimeedit.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qtimeedit.html#maxValue">maxValue</a>().
  3520. </doc>
  3521. </property>
  3522. <property>
  3523.     <name>QTimeEdit::minValue</name>
  3524.     <doc href="qtimeedit.html#minValue-prop"> <p>This property holds the minimum time value.
  3525. <p>Setting the minimum time value is equivalent to calling
  3526. <a href="qtimeedit.html#setRange">QTimeEdit::setRange</a>( <em>t</em>, <a href="qtimeedit.html#maxValue">maxValue</a>() ), where <em>t</em> is the
  3527. minimum time. The default minimum time is 00:00:00.
  3528.  
  3529. <p>Set this property's value with <a href="qtimeedit.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qtimeedit.html#minValue">minValue</a>().
  3530. </doc>
  3531. </property>
  3532. <property>
  3533.     <name>QTimeEdit::time</name>
  3534.     <doc href="qtimeedit.html#time-prop"> <p>This property holds the time value of the editor.
  3535. <p>When changing the time property, if the time is less than <a href="qtimeedit.html#minValue">minValue</a>(),
  3536. or is greater than <a href="qtimeedit.html#maxValue">maxValue</a>(), nothing happens.
  3537. <p> 
  3538. <p>Set this property's value with <a href="qtimeedit.html#setTime">setTime</a>() and get this property's value with <a href="qtimeedit.html#time">time</a>().
  3539. </doc>
  3540. </property>
  3541. <property>
  3542.     <name>QToolBar::label</name>
  3543.     <doc href="qtoolbar.html#label-prop">
  3544. <p>This property holds the label of the toolbar.
  3545. <p>If the toolbar is floated the label becomes the toolbar window's
  3546. caption. There is no default label text.
  3547.  
  3548. <p>Set this property's value with <a href="qtoolbar.html#setLabel">setLabel</a>() and get this property's value with <a href="qtoolbar.html#label">label</a>().
  3549. </doc>
  3550. </property>
  3551. <property>
  3552.     <name>QToolButton::autoRaise</name>
  3553.     <doc href="qtoolbutton.html#autoRaise-prop">
  3554. <p>This property holds whether auto-raising is enabled.
  3555. <p>The default is disabled (i.e. FALSE).
  3556.  
  3557. <p>Set this property's value with <a href="qtoolbutton.html#setAutoRaise">setAutoRaise</a>() and get this property's value with <a href="qtoolbutton.html#autoRaise">autoRaise</a>().
  3558. </doc>
  3559. </property>
  3560. <property>
  3561.     <name>QToolButton::iconSet</name>
  3562.     <doc href="qtoolbutton.html#iconSet-prop"> <p>This property holds the icon set providing the icon shown on the button.
  3563. <p>Setting this property sets <a href="qbutton.html#pixmap-prop">QToolButton::pixmap</a> to a null pixmap.
  3564. There is no default iconset.
  3565. <p> <p>See also <a href="qbutton.html#pixmap-prop">pixmap</a>, <a href="qtoolbutton.html#toggleButton-prop">toggleButton</a> and <a href="qtoolbutton.html#on-prop">on</a>.
  3566.  
  3567. <p>Set this property's value with <a href="qtoolbutton.html#setIconSet">setIconSet</a>() and get this property's value with <a href="qtoolbutton.html#iconSet">iconSet</a>().
  3568. </doc>
  3569. </property>
  3570. <property>
  3571.     <name>QToolButton::offIconSet</name>
  3572.     <doc href="qtoolbutton.html#offIconSet-prop">
  3573. <p>This property holds the icon set that is used when the button is in an "off" state.
  3574. <p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  3575. <p> Since Qt 3.0, <a href="qiconset.html">QIconSet</a> contains both the On and Off icons. There is
  3576. now an <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a> property that replaces both <a href="qtoolbutton.html#onIconSet-prop">QToolButton::onIconSet</a> and <a href="qtoolbutton.html#offIconSet-prop">QToolButton::offIconSet</a>.
  3577. <p> For ease of porting, this property is a synonym for <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a>. You probably want to go over your application
  3578. code and use the QIconSet On/Off mechanism.
  3579. <p> <p>See also <a href="qtoolbutton.html#iconSet-prop">iconSet</a> and <a href="qiconset.html#State-enum">QIconSet::State</a>.
  3580.  
  3581. <p>Set this property's value with <a href="qtoolbutton.html#setOffIconSet">setOffIconSet</a>() and get this property's value with <a href="qtoolbutton.html#offIconSet">offIconSet</a>().
  3582. </doc>
  3583. </property>
  3584. <property>
  3585.     <name>QToolButton::onIconSet</name>
  3586.     <doc href="qtoolbutton.html#onIconSet-prop">
  3587. <p>This property holds the icon set that is used when the button is in an "on" state.
  3588. <p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
  3589. <p> Since Qt 3.0, <a href="qiconset.html">QIconSet</a> contains both the On and Off icons. There is
  3590. now an <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a> property that replaces both <a href="qtoolbutton.html#onIconSet-prop">QToolButton::onIconSet</a> and <a href="qtoolbutton.html#offIconSet-prop">QToolButton::offIconSet</a>.
  3591. <p> For ease of porting, this property is a synonym for <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a>. You probably want to go over your application
  3592. code and use the QIconSet On/Off mechanism.
  3593. <p> <p>See also <a href="qtoolbutton.html#iconSet-prop">iconSet</a> and <a href="qiconset.html#State-enum">QIconSet::State</a>.
  3594.  
  3595. <p>Set this property's value with <a href="qtoolbutton.html#setOnIconSet">setOnIconSet</a>() and get this property's value with <a href="qtoolbutton.html#onIconSet">onIconSet</a>().
  3596. </doc>
  3597. </property>
  3598. <property>
  3599.     <name>QToolButton::popupDelay</name>
  3600.     <doc href="qtoolbutton.html#popupDelay-prop">
  3601. <p>This property holds the time delay between pressing the button and the appearance of the associated popup menu in milliseconds.
  3602. <p>Usually this is around half a second. A value of 0 will add a
  3603. special section to the toolbutton that can be used to open the
  3604. popupmenu.
  3605. <p> <p>See also <a href="qtoolbutton.html#setPopup">setPopup</a>().
  3606.  
  3607. <p>Set this property's value with <a href="qtoolbutton.html#setPopupDelay">setPopupDelay</a>() and get this property's value with <a href="qtoolbutton.html#popupDelay">popupDelay</a>().
  3608. </doc>
  3609. </property>
  3610. <property>
  3611.     <name>QToolButton::textLabel</name>
  3612.     <doc href="qtoolbutton.html#textLabel-prop">
  3613. <p>This property holds the label of this button.
  3614. <p>Setting this property automatically sets the text as tool tip too.
  3615. There is no default text.
  3616.  
  3617. <p>Set this property's value with <a href="qtoolbutton.html#setTextLabel">setTextLabel</a>() and get this property's value with <a href="qtoolbutton.html#textLabel">textLabel</a>().
  3618. </doc>
  3619. </property>
  3620. <property>
  3621.     <name>QToolButton::usesBigPixmap</name>
  3622.     <doc href="qtoolbutton.html#usesBigPixmap-prop">
  3623. <p>This property holds whether this toolbutton uses big pixmaps.
  3624. <p>QToolButton automatically connects this property to the relevant signal
  3625. in the <a href="qmainwindow.html">QMainWindow</a> in which it resides.  We strongly recommend that
  3626. you use <a href="qmainwindow.html#setUsesBigPixmaps">QMainWindow::setUsesBigPixmaps</a>() instead.
  3627. <p> This property's default is TRUE.
  3628. <p> <b>Warning:</b> If you set some buttons (in a QMainWindow) to have big pixmaps and
  3629. others to have small pixmaps, QMainWindow may not get the geometry
  3630. right.
  3631.  
  3632. <p>Set this property's value with <a href="qtoolbutton.html#setUsesBigPixmap">setUsesBigPixmap</a>() and get this property's value with <a href="qtoolbutton.html#usesBigPixmap">usesBigPixmap</a>().
  3633. </doc>
  3634. </property>
  3635. <property>
  3636.     <name>QToolButton::usesTextLabel</name>
  3637.     <doc href="qtoolbutton.html#usesTextLabel-prop">
  3638. <p>This property holds whether the toolbutton displays a text label below the button pixmap.
  3639. <p>The default is FALSE.
  3640. <p> QToolButton automatically connects this slot to the relevant signal
  3641. in the <a href="qmainwindow.html">QMainWindow</a> in which is resides.
  3642.  
  3643. <p>Set this property's value with <a href="qtoolbutton.html#setUsesTextLabel">setUsesTextLabel</a>() and get this property's value with <a href="qtoolbutton.html#usesTextLabel">usesTextLabel</a>().
  3644. </doc>
  3645. </property>
  3646. <property>
  3647.     <name>QToolTipGroup::delay</name>
  3648.     <doc href="qtooltipgroup.html#delay-prop">
  3649. <p>This property holds whether the display of the group text is delayed.
  3650. <p>If set to TRUE (the default), the group text is displayed at the time of
  3651. the tool tip.  Otherwise, the group text is displayed immediately when the
  3652. cursor enters the widget.
  3653.  
  3654. <p>Set this property's value with <a href="qtooltipgroup.html#setDelay">setDelay</a>() and get this property's value with <a href="qtooltipgroup.html#delay">delay</a>().
  3655. </doc>
  3656. </property>
  3657. <property>
  3658.     <name>QToolTipGroup::enabled</name>
  3659.     <doc href="qtooltipgroup.html#enabled-prop">
  3660. <p>This property holds whether tool tips in the group are enabled.
  3661. <p>This property's default is TRUE.
  3662.  
  3663. <p>Set this property's value with <a href="qtooltipgroup.html#setEnabled">setEnabled</a>() and get this property's value with <a href="qtooltipgroup.html#enabled">enabled</a>().
  3664. </doc>
  3665. </property>
  3666. <property>
  3667.     <name>QWidget::acceptDrops</name>
  3668.     <doc href="qwidget.html#acceptDrops-prop"> <p>This property holds whether drop events are enabled for this widget.
  3669. <p>Setting this property to TRUE announces to the system that this
  3670. widget <em>may</em> be able to accept drop events.
  3671. <p> If the widgets is the desktop (<a href="qwidget.html#isDesktop">QWidget::isDesktop</a>()), this may fail
  3672. if another application is using the desktop; you can call
  3673. <a href="qwidget.html#acceptDrops">acceptDrops</a>() to test if this occurs.
  3674.  
  3675. <p>Set this property's value with <a href="qwidget.html#setAcceptDrops">setAcceptDrops</a>() and get this property's value with <a href="qwidget.html#acceptDrops">acceptDrops</a>().
  3676. </doc>
  3677. </property>
  3678. <property>
  3679.     <name>QWidget::autoMask</name>
  3680.     <doc href="qwidget.html#autoMask-prop"> <p>This property holds whether the auto mask feature is enabled for the widget.
  3681. <p>Transparent widgets use a mask to define their visible region.
  3682. QWidget has some built-in support to make the task of recalculating
  3683. the mask easier. When setting auto mask to TRUE, <a href="qwidget.html#updateMask">updateMask</a>() will
  3684. be called whenever the widget is resized or changes its focus
  3685. state. Note that you must reimplement updateMask() (which should
  3686. include a call to <a href="qwidget.html#setMask">setMask</a>()) or nothing will happen.
  3687. <p> Note: when you re-implement <a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>() or
  3688. <a href="qwidget.html#focusOutEvent">focusOutEvent</a>() in your custom widgets and still want to ensure
  3689. that the auto mask calculation works, you should add:
  3690. <p> <pre>
  3691.     if ( <a href="qwidget.html#autoMask">autoMask</a>() )
  3692.         <a href="qwidget.html#updateMask">updateMask</a>();
  3693.   </pre>
  3694.  
  3695. <p> at the end of your event handlers. This is true for all member
  3696. functions that change the appearance of the widget in a way that
  3697. requires a recalculation of the mask.
  3698. <p> While being a technically appealing concept, masks have a big
  3699. drawback: when using complex masks that cannot be expressed easily
  3700. with relatively simple regions, they can be very slow on some
  3701. window systems. The classic example is a transparent label. The
  3702. complex shape of its contents makes it necessary to represent its
  3703. mask by a bitmap, which consumes both memory and time.  If all you
  3704. want is to blend the background of several neighboring widgets
  3705. together seamlessly, you will probably want to use
  3706. <a href="qwidget.html#setBackgroundOrigin">setBackgroundOrigin</a>() rather than a mask.
  3707. <p> <p>See also <a href="qwidget.html#autoMask-prop">autoMask</a>, <a href="qwidget.html#updateMask">updateMask</a>(), <a href="qwidget.html#setMask">setMask</a>(), <a href="qwidget.html#clearMask">clearMask</a>() and <a href="qwidget.html#backgroundOrigin-prop">backgroundOrigin</a>.
  3708.  
  3709. <p>Set this property's value with <a href="qwidget.html#setAutoMask">setAutoMask</a>() and get this property's value with <a href="qwidget.html#autoMask">autoMask</a>().
  3710. </doc>
  3711. </property>
  3712. <property>
  3713.     <name>QWidget::backgroundBrush</name>
  3714.     <doc href="qwidget.html#backgroundBrush-prop"> <p>This property holds the widget's background brush.
  3715. <p>The background brush depends on a widget's palette and its
  3716. background mode.
  3717. <p> <p>See also <a href="qwidget.html#backgroundColor">backgroundColor</a>(), <a href="qwidget.html#backgroundPixmap">backgroundPixmap</a>(), <a href="qwidget.html#eraseColor">eraseColor</a>(), <a href="qwidget.html#palette-prop">palette</a> and <a href="qapplication.html#setPalette">QApplication::setPalette</a>().
  3718.  
  3719. <p>Get this property's value with <a href="qwidget.html#backgroundBrush">backgroundBrush</a>().
  3720. </doc>
  3721. </property>
  3722. <property>
  3723.     <name>QWidget::backgroundMode</name>
  3724.     <doc href="qwidget.html#backgroundMode-prop"> <p>This property holds the color role used for painting the background of the widget.
  3725. <p>setPaletteBackgroundColor() reads this property to determine which entry of
  3726. the <a href="qwidget.html#palette-prop">palette</a> to set.
  3727. <p> For most widgets the default suffices (PaletteBackground, typically
  3728. gray), but some need to use PaletteBase (the background color for
  3729. text output, typically white) or another role.
  3730. <p> <a href="qlistbox.html">QListBox</a>, which is "sunken" and uses the base color to contrast with
  3731. its environment, does this in its constructor:
  3732. <p> <pre>
  3733.     <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>( <a href="qt.html#BackgroundMode-enum">PaletteBase</a> );
  3734.   </pre>
  3735.  
  3736. <p> You will never need to set the background mode of a built-in widget
  3737. in Qt, but you might consider setting it in your custom widgets, so
  3738. that <a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>() works as expected.
  3739. <p> Note that two of the BackgroundMode values make no sense for
  3740. <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>(), namely FixedPixmap and FixedColor. You have to
  3741. call <a href="qwidget.html#setBackgroundPixmap">setBackgroundPixmap</a>() and setPaletteBackgroundColor() instead.
  3742.  
  3743. <p>Set this property's value with <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>() and get this property's value with <a href="qwidget.html#backgroundMode">backgroundMode</a>().
  3744. </doc>
  3745. </property>
  3746. <property>
  3747.     <name>QWidget::backgroundOrigin</name>
  3748.     <doc href="qwidget.html#backgroundOrigin-prop"> <p>This property holds the origin of the widget's background.
  3749. <p>The origin is either WidgetOrigin (the default), ParentOrigin or
  3750. WindowOrigin.
  3751. <p> This makes a difference only if the widget has a background pixmap,
  3752. in which case positioning matters. Using WindowOrigin for several
  3753. neighboring widgets makes the background blend together seamlessly.
  3754. <p> <p>See also <a href="qwidget.html#backgroundPixmap">backgroundPixmap</a>() and <a href="qwidget.html#backgroundMode-prop">backgroundMode</a>.
  3755.  
  3756. <p>Set this property's value with <a href="qwidget.html#setBackgroundOrigin">setBackgroundOrigin</a>() and get this property's value with <a href="qwidget.html#backgroundOrigin">backgroundOrigin</a>().
  3757. </doc>
  3758. </property>
  3759. <property>
  3760.     <name>QWidget::baseSize</name>
  3761.     <doc href="qwidget.html#baseSize-prop"> <p>This property holds the base size of the widget.
  3762. <p>The base size is used to calculate a proper widget size in case the
  3763. widget defines <a href="qwidget.html#sizeIncrement">sizeIncrement</a>().
  3764. <p> <p>See also <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>.
  3765.  
  3766. <p>Set this property's value with <a href="qwidget.html#setBaseSize">setBaseSize</a>() and get this property's value with <a href="qwidget.html#baseSize">baseSize</a>().
  3767. </doc>
  3768. </property>
  3769. <property>
  3770.     <name>QWidget::caption</name>
  3771.     <doc href="qwidget.html#caption-prop"> <p>This property holds the window caption (title).
  3772. <p>This property only makes sense for top-level widgets. If no caption
  3773. has been set, the caption is QString::null.
  3774. <p> <p>See also <a href="qwidget.html#icon-prop">icon</a> and <a href="qwidget.html#iconText-prop">iconText</a>.
  3775.  
  3776. <p>Set this property's value with <a href="qwidget.html#setCaption">setCaption</a>() and get this property's value with <a href="qwidget.html#caption">caption</a>().
  3777. </doc>
  3778. </property>
  3779. <property>
  3780.     <name>QWidget::childrenRect</name>
  3781.     <doc href="qwidget.html#childrenRect-prop"> <p>This property holds the bounding rectangle of the widget's children.
  3782. <p>Hidden children are excluded.
  3783. <p> <p>See also <a href="qwidget.html#childrenRegion-prop">childrenRegion</a> and <a href="qwidget.html#geometry-prop">geometry</a>.
  3784.  
  3785. <p>Get this property's value with <a href="qwidget.html#childrenRect">childrenRect</a>().
  3786. </doc>
  3787. </property>
  3788. <property>
  3789.     <name>QWidget::childrenRegion</name>
  3790.     <doc href="qwidget.html#childrenRegion-prop"> <p>This property holds the combined region occupied by the widget's children.
  3791. <p>Hidden children are excluded.
  3792. <p> <p>See also <a href="qwidget.html#childrenRect-prop">childrenRect</a> and <a href="qwidget.html#geometry-prop">geometry</a>.
  3793.  
  3794. <p>Get this property's value with <a href="qwidget.html#childrenRegion">childrenRegion</a>().
  3795. </doc>
  3796. </property>
  3797. <property>
  3798.     <name>QWidget::colorGroup</name>
  3799.     <doc href="qwidget.html#colorGroup-prop"> <p>This property holds the current color group of the widget palette.
  3800. <p>The color group is determined by the state of the widget. A
  3801. disabled widget has the <a href="qpalette.html#disabled">QPalette::disabled</a>() color group, a widget
  3802. with keyboard focus has the <a href="qpalette.html#active">QPalette::active</a>() color group, and an
  3803. inactive widget has the <a href="qpalette.html#inactive">QPalette::inactive</a>() color group.
  3804. <p> <p>See also <a href="qwidget.html#palette-prop">palette</a>.
  3805.  
  3806. <p>Get this property's value with <a href="qwidget.html#colorGroup">colorGroup</a>().
  3807. </doc>
  3808. </property>
  3809. <property>
  3810.     <name>QWidget::cursor</name>
  3811.     <doc href="qwidget.html#cursor-prop"> <p>This property holds the cursor shape for this widget.
  3812. <p>The mouse cursor will assume this shape when it's over this widget.
  3813. See the <a href="qt.html#CursorShape-enum">list of predefined cursor
  3814.   objects</a> for a range of useful shapes.
  3815. <p> An editor widget would for example use an I-beam cursor:
  3816. <pre>
  3817.     <a href="qwidget.html#setCursor">setCursor</a>( <a href="qt.html#CursorShape-enum">IbeamCursor</a> );
  3818.   </pre>
  3819.  
  3820. <p> If no cursor has been set, or after a call to <a href="qwidget.html#unsetCursor">unsetCursor</a>(), the
  3821. parent's cursor is used. The function unsetCursor() has no effect
  3822. on top-level widgets.
  3823. <p> <p>See also <a href="qapplication.html#setOverrideCursor">QApplication::setOverrideCursor</a>().
  3824.  
  3825. <p>Set this property's value with <a href="qwidget.html#setCursor">setCursor</a>(), get this property's value with <a href="qwidget.html#cursor">cursor</a>() and reset this property's value with <a href="qwidget.html#unsetCursor">unsetCursor</a>().
  3826. </doc>
  3827. </property>
  3828. <property>
  3829.     <name>QWidget::customWhatsThis</name>
  3830.     <doc href="qwidget.html#customWhatsThis-prop"> <p>This property holds whether the widget wants to handle What's This help manually.
  3831. <p>The default implementation of <a href="qwidget.html#customWhatsThis">customWhatsThis</a>() returns FALSE,
  3832. which means the widget will not receive any events in Whats This
  3833. mode.
  3834. <p> The widget may leave What's This mode by calling
  3835. <a href="qwhatsthis.html#leaveWhatsThisMode">QWhatsThis::leaveWhatsThisMode</a>(), with or without actually
  3836. displaying any help text.
  3837. <p> You can also reimplement customWhatsThis() if your widget is a
  3838. "passive interactor" supposed to work under all circumstances.
  3839. Simply don't call QWhatsThis::leaveWhatsThisMode() in that case.
  3840. <p> <p>See also <a href="qwhatsthis.html#inWhatsThisMode">QWhatsThis::inWhatsThisMode</a>() and <a href="qwhatsthis.html#leaveWhatsThisMode">QWhatsThis::leaveWhatsThisMode</a>().
  3841.  
  3842. <p>Get this property's value with <a href="qwidget.html#customWhatsThis">customWhatsThis</a>().
  3843. </doc>
  3844. </property>
  3845. <property>
  3846.     <name>QWidget::enabled</name>
  3847.     <doc href="qwidget.html#enabled-prop"> <p>This property holds whether the widget is enabled.
  3848. <p>An enabled widget receives keyboard and mouse events; a disabled
  3849. widget does not. In fact, an enabled widget only receives keyboard
  3850. events when it is in focus.
  3851. <p> Some widgets display themselves differently when they are disabled.
  3852. For example a button might draw its label grayed out. If your widget
  3853. needs to know when it becomes enabled or disabled, you can
  3854. reimplement the <a href="qwidget.html#enabledChange">enabledChange</a>() function.
  3855. <p> Disabling a widget implicitly disables all its children. Enabling
  3856. respectively enables all child widgets unless they have been
  3857. explicitly disabled.
  3858. <p> <p>See also <a href="qwidget.html#enabled-prop">enabled</a>, <a href="qwidget.html#isEnabledTo">isEnabledTo</a>(), <a href="qkeyevent.html">QKeyEvent</a>, <a href="qmouseevent.html">QMouseEvent</a> and <a href="qwidget.html#enabledChange">enabledChange</a>().
  3859.  
  3860. <p>Set this property's value with <a href="qwidget.html#setEnabled">setEnabled</a>() and get this property's value with <a href="qwidget.html#isEnabled">isEnabled</a>().
  3861. </doc>
  3862. </property>
  3863. <property>
  3864.     <name>QWidget::focus</name>
  3865.     <doc href="qwidget.html#focus-prop"> <p>This property holds whether this widget (or its focus proxy) has the keyboard input focus.
  3866. <p>Effectively equivalent to <tt>qApp-&gt;focusWidget() == this</tt>.
  3867. <p> <p>See also <a href="qwidget.html#setFocus">setFocus</a>(), <a href="qwidget.html#clearFocus">clearFocus</a>(), <a href="qwidget.html#focusPolicy-prop">focusPolicy</a> and <a href="qapplication.html#focusWidget">QApplication::focusWidget</a>().
  3868.  
  3869. <p>Get this property's value with <a href="qwidget.html#hasFocus">hasFocus</a>().
  3870. </doc>
  3871. </property>
  3872. <property>
  3873.     <name>QWidget::focusEnabled</name>
  3874.     <doc href="qwidget.html#focusEnabled-prop"> <p>This property holds whether the widget accepts keyboard focus.
  3875. <p>Keyboard focus is initially disabled (i.e. <a href="qwidget.html#focusPolicy">focusPolicy</a>() ==
  3876. QWidget::NoFocus).
  3877. <p> You must enable keyboard focus for a widget if it processes keyboard
  3878. events.  This is normally done from the widget's constructor.  For
  3879. instance, the <a href="qlineedit.html">QLineEdit</a> constructor calls
  3880. <a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>(QWidget::StrongFocus).
  3881. <p> <p>See also <a href="qwidget.html#focusPolicy-prop">focusPolicy</a>, <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>() and <a href="qwidget.html#enabled-prop">enabled</a>.
  3882.  
  3883. <p>Get this property's value with <a href="qwidget.html#isFocusEnabled">isFocusEnabled</a>().
  3884. </doc>
  3885. </property>
  3886. <property>
  3887.     <name>QWidget::focusPolicy</name>
  3888.     <doc href="qwidget.html#focusPolicy-prop"> <p>This property holds the way the widget accepts keyboard focus.
  3889. <p>The policy is QWidget::TabFocus if the widget accepts keyboard
  3890. focus by tabbing, QWidget::ClickFocus if the widget accepts focus
  3891. by clicking, QWidget::StrongFocus if it accepts both and
  3892. QWidget::NoFocus if it does not accept focus at all (the default
  3893. for QWidget).
  3894. <p> You must enable keyboard focus for a widget if it processes
  3895. keyboard events. This is normally done from the widget's
  3896. constructor. For instance, the <a href="qlineedit.html">QLineEdit</a> constructor calls
  3897. <a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>(QWidget::StrongFocus).
  3898. <p> <p>See also <a href="qwidget.html#focusEnabled-prop">focusEnabled</a>, <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>() and <a href="qwidget.html#enabled-prop">enabled</a>.
  3899.  
  3900. <p>Set this property's value with <a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>() and get this property's value with <a href="qwidget.html#focusPolicy">focusPolicy</a>().
  3901. </doc>
  3902. </property>
  3903. <property>
  3904.     <name>QWidget::font</name>
  3905.     <doc href="qwidget.html#font-prop"> <p>This property holds the font currently set for the widget.
  3906. <p>The <a href="qwidget.html#fontInfo">fontInfo</a>() function reports the actual font that is being used by the
  3907. widget.
  3908. <p> As long as no special font has been set, or after <a href="qwidget.html#unsetFont">unsetFont</a>() is
  3909. called, this is either a special font for the widget class, the
  3910. parent's font or (if this widget is a top level widget) the default
  3911. application font.
  3912. <p> This code fragment sets a 12 point helvetica bold font:
  3913. <pre>
  3914.     <a href="qfont.html">QFont</a> f( "Helvetica", 12, QFont::Bold );
  3915.     <a href="qwidget.html#setFont">setFont</a>( f );
  3916.   </pre>
  3917.  
  3918. <p> Apart from setting the font, <a href="qwidget.html#setFont">setFont</a>() informs all children about
  3919. the change.
  3920. <p> <p>See also <a href="qwidget.html#fontChange">fontChange</a>(), <a href="qwidget.html#fontInfo">fontInfo</a>(), <a href="qwidget.html#fontMetrics">fontMetrics</a>() and <a href="qwidget.html#ownFont-prop">ownFont</a>.
  3921.  
  3922. <p>Set this property's value with <a href="qwidget.html#setFont">setFont</a>(), get this property's value with <a href="qwidget.html#font">font</a>() and reset this property's value with <a href="qwidget.html#unsetFont">unsetFont</a>().
  3923. </doc>
  3924. </property>
  3925. <property>
  3926.     <name>QWidget::frameGeometry</name>
  3927.     <doc href="qwidget.html#frameGeometry-prop"> <p>This property holds geometry of the widget relative to its parent including any window frame.
  3928. <p>See the <a href="geometry.html">Window Geometry documentation</a>
  3929. for an overview of geometry issues with top-level widgets.
  3930. <p> <p>See also <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#x-prop">x</a>, <a href="qwidget.html#y-prop">y</a> and <a href="qwidget.html#pos-prop">pos</a>.
  3931.  
  3932. <p>Get this property's value with <a href="qwidget.html#frameGeometry">frameGeometry</a>().
  3933. </doc>
  3934. </property>
  3935. <property>
  3936.     <name>QWidget::frameSize</name>
  3937.     <doc href="qwidget.html#frameSize-prop"> <p>This property holds the size of the widget including any window frame.
  3938. <p>
  3939. <p>Get this property's value with <a href="qwidget.html#frameSize">frameSize</a>().
  3940. </doc>
  3941. </property>
  3942. <property>
  3943.     <name>QWidget::geometry</name>
  3944.     <doc href="qwidget.html#geometry-prop"> <p>This property holds the geometry of the widget relative to its parent and excluding the window frame.
  3945. <p>When changing the geometry, the widget, if visible, receives a move
  3946. event (<a href="qwidget.html#moveEvent">moveEvent</a>()) and/or a resize event (<a href="qwidget.html#resizeEvent">resizeEvent</a>())
  3947. immediately. If the widget is not currently visible, it is
  3948. guaranteed to receive appropriate events before it is shown.
  3949. <p> The size component is adjusted if it lies outside the range defined
  3950. by <a href="qwidget.html#minimumSize">minimumSize</a>() and <a href="qwidget.html#maximumSize">maximumSize</a>().
  3951. <p> <a href="qwidget.html#setGeometry">setGeometry</a>() is virtual, and all other overloaded setGeometry()
  3952. implementations in Qt call it.
  3953. <p> <b>Warning:</b> If you call setGeometry() from resizeEvent() or
  3954. moveEvent(), you may experience infinite recursion.
  3955. <p> See the <a href="geometry.html">Window Geometry documentation</a>
  3956. for an overview of geometry issues with top-level widgets.
  3957. <p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#rect-prop">rect</a>, <a href="qwidget.html#pos-prop">pos</a>, <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#moveEvent">moveEvent</a>(), <a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#maximumSize-prop">maximumSize</a>.
  3958.  
  3959. <p>Set this property's value with <a href="qwidget.html#setGeometry">setGeometry</a>() and get this property's value with <a href="qwidget.html#geometry">geometry</a>().
  3960. </doc>
  3961. </property>
  3962. <property>
  3963.     <name>QWidget::height</name>
  3964.     <doc href="qwidget.html#height-prop"> <p>This property holds the height of the widget excluding any window frame.
  3965. <p>See the <a href="geometry.html">Window Geometry documentation</a>
  3966. for an overview of geometry issues with top-level widgets.
  3967. <p> <p>See also <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#width-prop">width</a> and <a href="qwidget.html#size-prop">size</a>.
  3968.  
  3969. <p>Get this property's value with <a href="qwidget.html#height">height</a>().
  3970. </doc>
  3971. </property>
  3972. <property>
  3973.     <name>QWidget::hidden</name>
  3974.     <doc href="qwidget.html#hidden-prop"> <p>This property holds whether the widget is explicitly hidden.
  3975. <p>If FALSE, the widget is visible or would become visible if all its
  3976. ancestors became visible.
  3977. <p> <p>See also <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#visible-prop">visible</a> and <a href="qwidget.html#isVisibleTo">isVisibleTo</a>().
  3978.  
  3979. <p>Get this property's value with <a href="qwidget.html#isHidden">isHidden</a>().
  3980. </doc>
  3981. </property>
  3982. <property>
  3983.     <name>QWidget::icon</name>
  3984.     <doc href="qwidget.html#icon-prop"> <p>This property holds the widget icon pixmap.
  3985. <p>This property makes sense only for top-level widgets. If no icon
  3986. has been set, <a href="qwidget.html#icon">icon</a>() returns 0.
  3987. <p> <p>See also <a href="qwidget.html#iconText-prop">iconText</a>, <a href="qwidget.html#caption-prop">caption</a> and <a href="appicon.html">Setting the Application Icon</a>.
  3988.  
  3989. <p>Set this property's value with <a href="qwidget.html#setIcon">setIcon</a>() and get this property's value with <a href="qwidget.html#icon">icon</a>().
  3990. </doc>
  3991. </property>
  3992. <property>
  3993.     <name>QWidget::iconText</name>
  3994.     <doc href="qwidget.html#iconText-prop"> <p>This property holds the widget icon text.
  3995. <p>This property makes sense only for top-level widgets. If no icon
  3996. text has been set, this functions returns QString::null.
  3997. <p> <p>See also <a href="qwidget.html#icon-prop">icon</a> and <a href="qwidget.html#caption-prop">caption</a>.
  3998.  
  3999. <p>Set this property's value with <a href="qwidget.html#setIconText">setIconText</a>() and get this property's value with <a href="qwidget.html#iconText">iconText</a>().
  4000. </doc>
  4001. </property>
  4002. <property>
  4003.     <name>QWidget::isActiveWindow</name>
  4004.     <doc href="qwidget.html#isActiveWindow-prop"> <p>This property holds whether this widget is the active window or a child of it.
  4005. <p>The active window is the window that has keyboard focus.
  4006. <p> When popup windows are visible, this property is TRUE for both the
  4007. active window <em>and</em> for the popup.
  4008. <p> <p>See also <a href="qwidget.html#setActiveWindow">setActiveWindow</a>() and <a href="qapplication.html#activeWindow">QApplication::activeWindow</a>().
  4009.  
  4010. <p>Get this property's value with <a href="qwidget.html#isActiveWindow">isActiveWindow</a>().
  4011. </doc>
  4012. </property>
  4013. <property>
  4014.     <name>QWidget::isDesktop</name>
  4015.     <doc href="qwidget.html#isDesktop-prop"> <p>This property holds whether the widget is a desktop widget.
  4016. <p>A desktop widget is also a top-level widget.
  4017. <p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a> and <a href="qapplication.html#desktop">QApplication::desktop</a>().
  4018.  
  4019. <p>Get this property's value with <a href="qwidget.html#isDesktop">isDesktop</a>().
  4020. </doc>
  4021. </property>
  4022. <property>
  4023.     <name>QWidget::isDialog</name>
  4024.     <doc href="qwidget.html#isDialog-prop"> <p>This property holds whether the widget is a dialog widget.
  4025. <p>A dialog widget is a secondary top-level widget.
  4026. <p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a> and <a href="qdialog.html">QDialog</a>.
  4027.  
  4028. <p>Get this property's value with <a href="qwidget.html#isDialog">isDialog</a>().
  4029. </doc>
  4030. </property>
  4031. <property>
  4032.     <name>QWidget::isModal</name>
  4033.     <doc href="qwidget.html#isModal-prop"> <p>This property holds whether the widget is a modal widget.
  4034. <p>This property only makes sense for top-level widgets. A modal
  4035. widget prevents widgets in all other top-level widgets from getting
  4036. any input.
  4037. <p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a>, <a href="qwidget.html#isDialog-prop">isDialog</a> and <a href="qdialog.html">QDialog</a>.
  4038.  
  4039. <p>Get this property's value with <a href="qwidget.html#isModal">isModal</a>().
  4040. </doc>
  4041. </property>
  4042. <property>
  4043.     <name>QWidget::isPopup</name>
  4044.     <doc href="qwidget.html#isPopup-prop"> <p>This property holds whether the widget is a popup widget.
  4045. <p>A popup widget is created by specifying the widget flag <a href="qt.html#WidgetFlags-enum">WType_Popup</a> to the widget constructor. A popup widget is also a
  4046. top-level widget.
  4047. <p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a>.
  4048.  
  4049. <p>Get this property's value with <a href="qwidget.html#isPopup">isPopup</a>().
  4050. </doc>
  4051. </property>
  4052. <property>
  4053.     <name>QWidget::isTopLevel</name>
  4054.     <doc href="qwidget.html#isTopLevel-prop"> <p>This property holds whether the widget is a top-level widget.
  4055. <p>A top-level widget is a widget which usually has a frame and a <a href="qwidget.html#caption-prop">caption (title)</a>. <a href="qwidget.html#isPopup">Popup</a> and <a href="qwidget.html#isDesktop">desktop</a> widgets
  4056. are also top-level widgets.
  4057. <p> A top-level widget can have a <a href="qwidget.html#parentWidget">parent
  4058.   widget</a>. It will then be grouped with its parent: deleted
  4059. when the parent is deleted, minimized when the parent is minimized
  4060. etc. If supported by the window manager, it will also have a common
  4061. taskbar entry with its parent.
  4062. <p> <a href="qdialog.html">QDialog</a> and <a href="qmainwindow.html">QMainWindow</a> widgets are by default top-level, even if a
  4063. parent widget is specified in the constructor. This behavior is
  4064. specified by the <a href="qt.html#WidgetFlags-enum">WType_TopLevel</a> widget flag.
  4065. <p> Child widgets are the opposite of top-level widgets.
  4066. <p> <p>See also <a href="qwidget.html#topLevelWidget">topLevelWidget</a>(), <a href="qwidget.html#isDialog-prop">isDialog</a>, <a href="qwidget.html#isModal-prop">isModal</a>, <a href="qwidget.html#isPopup-prop">isPopup</a>, <a href="qwidget.html#isDesktop-prop">isDesktop</a> and <a href="qwidget.html#parentWidget">parentWidget</a>().
  4067.  
  4068. <p>Get this property's value with <a href="qwidget.html#isTopLevel">isTopLevel</a>().
  4069. </doc>
  4070. </property>
  4071. <property>
  4072.     <name>QWidget::maximumHeight</name>
  4073.     <doc href="qwidget.html#maximumHeight-prop"> <p>This property holds the widget's maximum height.
  4074. <p>This property corresponds to <a href="qwidget.html#maximumSize">maximumSize</a>().<a href="qwidget.html#height">height</a>().
  4075. <p> <p>See also <a href="qwidget.html#maximumSize-prop">maximumSize</a> and <a href="qwidget.html#maximumWidth-prop">maximumWidth</a>.
  4076.  
  4077. <p>Set this property's value with <a href="qwidget.html#setMaximumHeight">setMaximumHeight</a>() and get this property's value with <a href="qwidget.html#maximumHeight">maximumHeight</a>().
  4078. </doc>
  4079. </property>
  4080. <property>
  4081.     <name>QWidget::maximumSize</name>
  4082.     <doc href="qwidget.html#maximumSize-prop"> <p>This property holds the widget's maximum size.
  4083. <p>The widget cannot be resized to a larger size than the maximum widget
  4084. size.
  4085. <p> <p>See also <a href="qwidget.html#maximumWidth-prop">maximumWidth</a>, <a href="qwidget.html#maximumHeight-prop">maximumHeight</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>.
  4086.  
  4087. <p>Set this property's value with <a href="qwidget.html#setMaximumSize">setMaximumSize</a>() and get this property's value with <a href="qwidget.html#maximumSize">maximumSize</a>().
  4088. </doc>
  4089. </property>
  4090. <property>
  4091.     <name>QWidget::maximumWidth</name>
  4092.     <doc href="qwidget.html#maximumWidth-prop"> <p>This property holds the widget's maximum width.
  4093. <p>This property corresponds to <a href="qwidget.html#maximumSize">maximumSize</a>().<a href="qwidget.html#width">width</a>().
  4094. <p> <p>See also <a href="qwidget.html#maximumSize-prop">maximumSize</a> and <a href="qwidget.html#maximumHeight-prop">maximumHeight</a>.
  4095.  
  4096. <p>Set this property's value with <a href="qwidget.html#setMaximumWidth">setMaximumWidth</a>() and get this property's value with <a href="qwidget.html#maximumWidth">maximumWidth</a>().
  4097. </doc>
  4098. </property>
  4099. <property>
  4100.     <name>QWidget::microFocusHint</name>
  4101.     <doc href="qwidget.html#microFocusHint-prop"> <p>This property holds the currently set micro focus hint for this widget.
  4102. <p>See the documentation of <a href="qwidget.html#setMicroFocusHint">setMicroFocusHint</a>() for more information.
  4103.  
  4104. <p>Get this property's value with <a href="qwidget.html#microFocusHint">microFocusHint</a>().
  4105. </doc>
  4106. </property>
  4107. <property>
  4108.     <name>QWidget::minimized</name>
  4109.     <doc href="qwidget.html#minimized-prop"> <p>This property holds whether this widget is minimized (iconified).
  4110. <p>This property is relevant only for top-level widgets.
  4111. <p> <p>See also <a href="qwidget.html#showMinimized">showMinimized</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>() and <a href="qwidget.html#showNormal">showNormal</a>().
  4112.  
  4113. <p>Get this property's value with <a href="qwidget.html#isMinimized">isMinimized</a>().
  4114. </doc>
  4115. </property>
  4116. <property>
  4117.     <name>QWidget::minimumHeight</name>
  4118.     <doc href="qwidget.html#minimumHeight-prop"> <p>This property holds the widget's minimum height.
  4119. <p>This property corresponds to <a href="qwidget.html#minimumSize">minimumSize</a>().<a href="qwidget.html#height">height</a>().
  4120. <p> <p>See also <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#minimumWidth-prop">minimumWidth</a>.
  4121.  
  4122. <p>Set this property's value with <a href="qwidget.html#setMinimumHeight">setMinimumHeight</a>() and get this property's value with <a href="qwidget.html#minimumHeight">minimumHeight</a>().
  4123. </doc>
  4124. </property>
  4125. <property>
  4126.     <name>QWidget::minimumSize</name>
  4127.     <doc href="qwidget.html#minimumSize-prop"> <p>This property holds the widget's minimum size.
  4128. <p>The widget cannot be resized to a smaller size than the minimum widget
  4129. size. The widget's size is forced to the minimum size if the current
  4130. size is smaller.
  4131. <p> If you use a layout inside the widget, the minimum size will be set
  4132. by the layout and not by <a href="qwidget.html#setMinimumSize">setMinimumSize</a>(), unless you set the
  4133. layout's resize mode to QLayout::FreeResize.
  4134. <p> <p>See also <a href="qwidget.html#minimumWidth-prop">minimumWidth</a>, <a href="qwidget.html#minimumHeight-prop">minimumHeight</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>, <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a> and <a href="qlayout.html#resizeMode-prop">QLayout::resizeMode</a>.
  4135.  
  4136. <p>Set this property's value with <a href="qwidget.html#setMinimumSize">setMinimumSize</a>() and get this property's value with <a href="qwidget.html#minimumSize">minimumSize</a>().
  4137. </doc>
  4138. </property>
  4139. <property>
  4140.     <name>QWidget::minimumSizeHint</name>
  4141.     <doc href="qwidget.html#minimumSizeHint-prop"> <p>This property holds the recommended minimum size for the widget.
  4142. <p>If the value of this property is an invalid size, no minimum size
  4143. is recommended.
  4144. <p> The default implementation of <a href="qwidget.html#minimumSizeHint">minimumSizeHint</a>() returns an invalid
  4145. size if there is no layout for this widget, and returns the layout's
  4146. minimum size otherwise. Most built-in widgets reimplement
  4147. minimumSizeHint().
  4148. <p> <a href="qlayout.html">QLayout</a> will never resize a widget to a size smaller than
  4149. minimumSizeHint.
  4150. <p> <p>See also <a href="qsize.html#isValid">QSize::isValid</a>(), <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>.
  4151.  
  4152. <p>Get this property's value with <a href="qwidget.html#minimumSizeHint">minimumSizeHint</a>().
  4153. </doc>
  4154. </property>
  4155. <property>
  4156.     <name>QWidget::minimumWidth</name>
  4157.     <doc href="qwidget.html#minimumWidth-prop"> <p>This property holds the widget's minimum width.
  4158. <p>This property corresponds to <a href="qwidget.html#minimumSize">minimumSize</a>().<a href="qwidget.html#width">width</a>().
  4159. <p> <p>See also <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#minimumHeight-prop">minimumHeight</a>.
  4160.  
  4161. <p>Set this property's value with <a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>() and get this property's value with <a href="qwidget.html#minimumWidth">minimumWidth</a>().
  4162. </doc>
  4163. </property>
  4164. <property>
  4165.     <name>QWidget::mouseTracking</name>
  4166.     <doc href="qwidget.html#mouseTracking-prop"> <p>This property holds whether mouse tracking is enabled for this widget.
  4167. <p>If mouse tracking is disabled (the default), this widget only
  4168. receives mouse move events when at least one mouse button is
  4169. pressed down while the mouse is being moved.
  4170. <p> If mouse tracking is enabled, this widget receives mouse move
  4171. events even if no buttons are pressed down.
  4172. <p> <p>See also <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>() and <a href="qapplication.html#setGlobalMouseTracking">QApplication::setGlobalMouseTracking</a>().
  4173.  
  4174. <p>Set this property's value with <a href="qwidget.html#setMouseTracking">setMouseTracking</a>() and get this property's value with <a href="qwidget.html#hasMouseTracking">hasMouseTracking</a>().
  4175. </doc>
  4176. </property>
  4177. <property>
  4178.     <name>QWidget::ownCursor</name>
  4179.     <doc href="qwidget.html#ownCursor-prop"> <p>This property holds whether the widget uses its own cursor.
  4180. <p>If FALSE, the widget uses its parent widget's cursor.
  4181. <p> <p>See also <a href="qwidget.html#cursor-prop">cursor</a>.
  4182.  
  4183. <p>Get this property's value with <a href="qwidget.html#ownCursor">ownCursor</a>().
  4184. </doc>
  4185. </property>
  4186. <property>
  4187.     <name>QWidget::ownFont</name>
  4188.     <doc href="qwidget.html#ownFont-prop"> <p>This property holds whether the widget uses its own font.
  4189. <p>If FALSE, the widget uses its parent widget's font.
  4190. <p> <p>See also <a href="qwidget.html#font-prop">font</a>.
  4191.  
  4192. <p>Get this property's value with <a href="qwidget.html#ownFont">ownFont</a>().
  4193. </doc>
  4194. </property>
  4195. <property>
  4196.     <name>QWidget::ownPalette</name>
  4197.     <doc href="qwidget.html#ownPalette-prop"> <p>This property holds whether the widget uses its own palette.
  4198. <p>If FALSE, the widget uses its parent widget's palette.
  4199. <p> <p>See also <a href="qwidget.html#palette-prop">palette</a>.
  4200.  
  4201. <p>Get this property's value with <a href="qwidget.html#ownPalette">ownPalette</a>().
  4202. </doc>
  4203. </property>
  4204. <property>
  4205.     <name>QWidget::palette</name>
  4206.     <doc href="qwidget.html#palette-prop"> <p>This property holds the widget's palette.
  4207. <p>As long as no special palette has been set, or after <a href="qwidget.html#unsetPalette">unsetPalette</a>()
  4208. has been called, this is either a special palette for the widget
  4209. class, the parent's palette or (if this widget is a top level
  4210. widget) the default application palette.
  4211. <p> Instead of defining an entirely new palette, you can also use the
  4212. <a href="qwidget.html#paletteBackgroundColor-prop">paletteBackgroundColor</a>,
  4213. <a href="qwidget.html#paletteBackgroundPixmap-prop">paletteBackgroundPixmap</a> and
  4214. <a href="qwidget.html#paletteForegroundColor-prop">paletteForegroundColor</a>
  4215. convenience properties to change a widget's
  4216. background and foreground appearance only.
  4217. <p> <p>See also <a href="qwidget.html#ownPalette-prop">ownPalette</a>, <a href="qwidget.html#colorGroup-prop">colorGroup</a> and <a href="qapplication.html#palette">QApplication::palette</a>().
  4218.  
  4219. <p>Set this property's value with <a href="qwidget.html#setPalette">setPalette</a>(), get this property's value with <a href="qwidget.html#palette">palette</a>() and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>().
  4220. </doc>
  4221. </property>
  4222. <property>
  4223.     <name>QWidget::paletteBackgroundColor</name>
  4224.     <doc href="qwidget.html#paletteBackgroundColor-prop"> <p>This property holds the background color of the widget.
  4225. <p>The palette background color is usually set implicitly by
  4226. <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>(), although it can also be set explicitly by
  4227. <a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>().  setPaletteBackgroundColor() is a
  4228. convenience function that creates and sets a modified <a href="qpalette.html">QPalette</a> with
  4229. <a href="qwidget.html#setPalette">setPalette</a>(). The palette is modified according to the widget's
  4230. background mode. For example, if the background mode is
  4231. PaletteButton the color used for the palette's QColorGroup::Button
  4232. color entry is set.
  4233. <p> If there is a background pixmap (set using
  4234. <a href="qwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>()), then the return value of this
  4235. function is indeterminate.
  4236. <p> <p>See also <a href="qwidget.html#paletteBackgroundPixmap-prop">paletteBackgroundPixmap</a>, <a href="qwidget.html#paletteForegroundColor-prop">paletteForegroundColor</a>, <a href="qwidget.html#palette-prop">palette</a> and <a href="qwidget.html#colorGroup-prop">colorGroup</a>.
  4237.  
  4238. <p>Set this property's value with <a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>(), get this property's value with <a href="qwidget.html#paletteBackgroundColor">paletteBackgroundColor</a>() and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>().
  4239. </doc>
  4240. </property>
  4241. <property>
  4242.     <name>QWidget::paletteBackgroundPixmap</name>
  4243.     <doc href="qwidget.html#paletteBackgroundPixmap-prop"> <p>This property holds the background pixmap of the widget.
  4244. <p>The palette background pixmap is usually set implicitly by
  4245. <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>(), although it can also be set explicitly by
  4246. <a href="qwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>().  setPaletteBackgroundPixmap() is a
  4247. convenience function that creates and sets a modified <a href="qpalette.html">QPalette</a> with
  4248. <a href="qwidget.html#setPalette">setPalette</a>(). The palette is modified according to the widget's
  4249. background mode. For example, if the background mode is
  4250. PaletteButton the pixmap used for the palette's QColorGroup::Button
  4251. color entry is set.
  4252. <p> If there is a plain background color (set using
  4253. <a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>()), then this function returns 0.
  4254. <p> <p>See also <a href="qwidget.html#paletteBackgroundColor-prop">paletteBackgroundColor</a>, <a href="qwidget.html#paletteForegroundColor-prop">paletteForegroundColor</a>, <a href="qwidget.html#palette-prop">palette</a> and <a href="qwidget.html#colorGroup-prop">colorGroup</a>.
  4255.  
  4256. <p>Set this property's value with <a href="qwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>(), get this property's value with <a href="qwidget.html#paletteBackgroundPixmap">paletteBackgroundPixmap</a>() and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>().
  4257. </doc>
  4258. </property>
  4259. <property>
  4260.     <name>QWidget::paletteForegroundColor</name>
  4261.     <doc href="qwidget.html#paletteForegroundColor-prop"> <p>This property holds the foreground color of the widget.
  4262. <p>setPaletteForegroundColor() is a convenience function that creates and
  4263. sets a modified <a href="qpalette.html">QPalette</a> with <a href="qwidget.html#setPalette">setPalette</a>(). The palette is modified
  4264. according to the widget's <em>background mode</em>. For example, if the
  4265. background mode is PaletteButton the palette entry
  4266. QColorGroup::ButtonText is set to color.
  4267. <p> <p>See also <a href="qwidget.html#palette-prop">palette</a>, <a href="qapplication.html#setPalette">QApplication::setPalette</a>(), <a href="qwidget.html#backgroundMode-prop">backgroundMode</a>, <a href="qwidget.html#foregroundColor">foregroundColor</a>(), <a href="qwidget.html#backgroundMode-prop">backgroundMode</a> and <a href="qwidget.html#setEraseColor">setEraseColor</a>().
  4268.  
  4269. <p>Set this property's value with <a href="qwidget.html#setPaletteForegroundColor">setPaletteForegroundColor</a>(), get this property's value with <a href="qwidget.html#paletteForegroundColor">paletteForegroundColor</a>() and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>().
  4270. </doc>
  4271. </property>
  4272. <property>
  4273.     <name>QWidget::pos</name>
  4274.     <doc href="qwidget.html#pos-prop"> <p>This property holds the position of the widget in its parent widget.
  4275. <p>If the widget is a top-level widget, the position is that of the
  4276. widget on the desktop, including the frame.
  4277. <p> When changing the position, the widget, if visible, receives a move
  4278. event (<a href="qwidget.html#moveEvent">moveEvent</a>()) immediately. If the widget is not currently
  4279. visible, it is guaranteed to receive an event before it is shown.
  4280. <p> <a href="qwidget.html#move">move</a>() is virtual, and all other overloaded move() implementations
  4281. in Qt call it.
  4282. <p> <b>Warning:</b> If you call move() or <a href="qwidget.html#setGeometry">setGeometry</a>() from moveEvent(), you
  4283. may experience infinite recursion.
  4284. <p> See the <a href="geometry.html">Window Geometry documentation</a>
  4285. for an overview of geometry issues with top-level widgets.
  4286. <p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#x-prop">x</a> and <a href="qwidget.html#y-prop">y</a>.
  4287.  
  4288. <p>Set this property's value with <a href="qwidget.html#move">move</a>() and get this property's value with <a href="qwidget.html#pos">pos</a>().
  4289. </doc>
  4290. </property>
  4291. <property>
  4292.     <name>QWidget::rect</name>
  4293.     <doc href="qwidget.html#rect-prop"> <p>This property holds the internal geometry of the widget excluding any window frame.
  4294. <p>The rect property equals <a href="qrect.html">QRect</a>(0, 0, <a href="qwidget.html#width">width</a>(), <a href="qwidget.html#height">height</a>()).
  4295. <p> See the <a href="geometry.html">Window Geometry documentation</a>
  4296. for an overview of geometry issues with top-level widgets.
  4297. <p> <p>See also <a href="qwidget.html#size-prop">size</a>.
  4298.  
  4299. <p>Get this property's value with <a href="qwidget.html#rect">rect</a>().
  4300. </doc>
  4301. </property>
  4302. <property>
  4303.     <name>QWidget::size</name>
  4304.     <doc href="qwidget.html#size-prop"> <p>This property holds the size of the widget excluding any window frame.
  4305. <p>When resizing, the widget, if visible, receives a resize event
  4306. (<a href="qwidget.html#resizeEvent">resizeEvent</a>()) immediately. If the widget is not currently visible,
  4307. it is guaranteed to receive an event before it is shown.
  4308. <p> The size is adjusted if it lies outside the range defined by
  4309. <a href="qwidget.html#minimumSize">minimumSize</a>() and <a href="qwidget.html#maximumSize">maximumSize</a>(). Furthermore, the size is always at
  4310. least <a href="qsize.html">QSize</a>(1, 1).
  4311. <p> <a href="qwidget.html#resize">resize</a>() is virtual, and all other overloaded resize()
  4312. implementations in Qt call it.
  4313. <p> <b>Warning:</b> If you call resize() or <a href="qwidget.html#setGeometry">setGeometry</a>() from resizeEvent(),
  4314. you may experience infinite recursion.
  4315. <p> <p>See also <a href="qwidget.html#pos-prop">pos</a>, <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a> and <a href="qwidget.html#resizeEvent">resizeEvent</a>().
  4316.  
  4317. <p>Set this property's value with <a href="qwidget.html#resize">resize</a>() and get this property's value with <a href="qwidget.html#size">size</a>().
  4318. </doc>
  4319. </property>
  4320. <property>
  4321.     <name>QWidget::sizeHint</name>
  4322.     <doc href="qwidget.html#sizeHint-prop"> <p>This property holds the recommended size for the widget.
  4323. <p>If the value of this property is an invalid size, no size is
  4324. recommended.
  4325. <p> The default implementation of <a href="qwidget.html#sizeHint">sizeHint</a>() returns an invalid size if
  4326. there is no layout for this widget, and returns the layout's
  4327. preferred size otherwise.
  4328. <p> <p>See also <a href="qsize.html#isValid">QSize::isValid</a>(), <a href="qwidget.html#minimumSizeHint-prop">minimumSizeHint</a>, <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#updateGeometry">updateGeometry</a>().
  4329.  
  4330. <p>Get this property's value with <a href="qwidget.html#sizeHint">sizeHint</a>().
  4331. </doc>
  4332. </property>
  4333. <property>
  4334.     <name>QWidget::sizeIncrement</name>
  4335.     <doc href="qwidget.html#sizeIncrement-prop"> <p>This property holds the size increment of the widget.
  4336. <p>When the user resizes the window, the size will move in steps of
  4337. <a href="qwidget.html#sizeIncrement">sizeIncrement</a>().<a href="qwidget.html#width">width</a>() pixels horizontally and
  4338. sizeIncrement.<a href="qwidget.html#height">height</a>() pixels vertically, with <a href="qwidget.html#baseSize">baseSize</a>() as basis.
  4339. Preferred widget sizes are for nonnegative integers <em>i</em>
  4340. and <em>j</em>:
  4341. <pre>
  4342.     <a href="qwidget.html#width-prop">width</a> = <a href="qwidget.html#baseSize">baseSize</a>().width() + i * sizeIncrement().width();
  4343.     <a href="qwidget.html#height-prop">height</a> = <a href="qwidget.html#baseSize">baseSize</a>().height() + j * sizeIncrement().height();
  4344.   </pre>
  4345.  
  4346. <p> Note that while you can set the size increment for all widgets, it
  4347. only effects top-level widgets.
  4348. <p> <b>Warning:</b> The size increment has no effect under Windows, and may be
  4349. disregarded by the window manager on X.
  4350. <p> <p>See also <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#maximumSize-prop">maximumSize</a>.
  4351.  
  4352. <p>Set this property's value with <a href="qwidget.html#setSizeIncrement">setSizeIncrement</a>() and get this property's value with <a href="qwidget.html#sizeIncrement">sizeIncrement</a>().
  4353. </doc>
  4354. </property>
  4355. <property>
  4356.     <name>QWidget::sizePolicy</name>
  4357.     <doc href="qwidget.html#sizePolicy-prop"> <p>This property holds the default layout behavior of the widget.
  4358. <p>If there is a <a href="qlayout.html">QLayout</a> that manages this widget's children, the size
  4359. policy specified by that layout is used. If there is no such
  4360. QLayout, the result of this function is used.
  4361. <p> The default policy is Preferred/Preferred, which means that the
  4362. widget can be freely resized, but prefers to be the size <a href="qwidget.html#sizeHint">sizeHint</a>()
  4363. returns. Button-like widgets set the size policy to specify that
  4364. they may stretch horizontally, but are fixed vertically. The same
  4365. applies to lineedit controls (such as <a href="qlineedit.html">QLineEdit</a>, <a href="qspinbox.html">QSpinBox</a> or an
  4366. editable <a href="qcombobox.html">QComboBox</a>) and other horizontally orientated widgets (such
  4367. as <a href="qprogressbar.html">QProgressBar</a>).  <a href="qtoolbutton.html">QToolButton</a>'s are normally square, so they allow
  4368. growth in both directions. Widgets that support different directions
  4369. (such as <a href="qslider.html">QSlider</a>, <a href="qscrollbar.html">QScrollBar</a> or <a href="qheader.html">QHeader</a>) specify stretching in the
  4370. respective direction only. Widgets that can provide scrollbars
  4371. (usually subclasses of <a href="qscrollview.html">QScrollView</a>) tend to specify that they can
  4372. use additional space, and that they can survive on less than
  4373. sizeHint().
  4374. <p> <p>See also <a href="qwidget.html#sizeHint-prop">sizeHint</a>, <a href="qlayout.html">QLayout</a>, <a href="qsizepolicy.html">QSizePolicy</a> and <a href="qwidget.html#updateGeometry">updateGeometry</a>().
  4375.  
  4376. <p>Set this property's value with <a href="qwidget.html#setSizePolicy">setSizePolicy</a>() and get this property's value with <a href="qwidget.html#sizePolicy">sizePolicy</a>().
  4377. </doc>
  4378. </property>
  4379. <property>
  4380.     <name>QWidget::underMouse</name>
  4381.     <doc href="qwidget.html#underMouse-prop"> <p>This property holds whether the widget is under the mouse cursor.
  4382. <p>This value is not updated properly during drag'n'drop operations.
  4383. <p> <p>See also <a href="qevent.html#Type-enum">QEvent::Enter</a> and <a href="qevent.html#Type-enum">QEvent::Leave</a>.
  4384.  
  4385. <p>Get this property's value with <a href="qwidget.html#hasMouse">hasMouse</a>().
  4386. </doc>
  4387. </property>
  4388. <property>
  4389.     <name>QWidget::updatesEnabled</name>
  4390.     <doc href="qwidget.html#updatesEnabled-prop"> <p>This property holds whether updates are enabled.
  4391. <p>Calling <a href="qwidget.html#update">update</a>() and <a href="qwidget.html#repaint">repaint</a>() has no effect if updates are disabled.
  4392. Paint events from the window system are processed normally even if
  4393. updates are disabled.
  4394. <p> <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>() is normally used to disable updates for a short
  4395. period of time, for instance to avoid screen flicker during large
  4396. changes.
  4397. <p> Example:
  4398. <pre>
  4399.     <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>( FALSE );
  4400.     bigVisualChanges();
  4401.     <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>( TRUE );
  4402.     <a href="qwidget.html#repaint">repaint</a>();
  4403.   </pre>
  4404.  
  4405. <p> <p>See also <a href="qwidget.html#update">update</a>(), <a href="qwidget.html#repaint">repaint</a>() and <a href="qwidget.html#paintEvent">paintEvent</a>().
  4406.  
  4407. <p>Set this property's value with <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>() and get this property's value with <a href="qwidget.html#isUpdatesEnabled">isUpdatesEnabled</a>().
  4408. </doc>
  4409. </property>
  4410. <property>
  4411.     <name>QWidget::visible</name>
  4412.     <doc href="qwidget.html#visible-prop"> <p>This property holds whether the widget is visible.
  4413. <p>Calling <a href="qwidget.html#show">show</a>() sets the widget to visible status if all its parent
  4414. widgets up to the top-level widget are visible. If an ancestor is
  4415. not visible, the widget won't become visible until all its
  4416. ancestors are shown.
  4417. <p> Calling <a href="qwidget.html#hide">hide</a>() hides a widget explicitly. An explicitly hidden
  4418. widget will never become visible, even if all its ancestors become
  4419. visible, unless you show it.
  4420. <p> Iconified top-level widgets also have hidden status, as well as
  4421. having <a href="qwidget.html#isMinimized">isMinimized</a>() return TRUE. Windows that exist on another
  4422. virtual desktop (on platforms that support this concept) also have
  4423. hidden status.
  4424. <p> A widget that happens to be obscured by other windows on the screen
  4425. is considered to be visible.
  4426. <p> A widget receives show and hide events when its visibility status
  4427. changes. Between a hide and a show event, there is no need in
  4428. wasting any CPU on preparing or displaying information to the
  4429. user. A video application, for example, might simply stop generating
  4430. new frames.
  4431. <p> <p>See also <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#hidden-prop">hidden</a>, <a href="qwidget.html#isVisibleTo">isVisibleTo</a>(), <a href="qwidget.html#minimized-prop">minimized</a>, <a href="qwidget.html#showEvent">showEvent</a>() and <a href="qwidget.html#hideEvent">hideEvent</a>().
  4432.  
  4433. <p>Get this property's value with <a href="qwidget.html#isVisible">isVisible</a>().
  4434. </doc>
  4435. </property>
  4436. <property>
  4437.     <name>QWidget::visibleRect</name>
  4438.     <doc href="qwidget.html#visibleRect-prop"> <p>This property holds the currently visible rectangle of the widget.
  4439. <p>This property is useful to optimize immediate repainting of a
  4440. widget. Typical usage is:
  4441. <pre>
  4442.     <a href="qwidget.html#repaint">repaint</a>( w-&gt;visibleRect() );
  4443.   </pre>
  4444.  
  4445. or
  4446. <pre>
  4447.     <a href="qwidget.html#repaint">repaint</a>( w-&gt;visibleRect(), FALSE );
  4448.   </pre>
  4449.  
  4450. <p> If nothing is visible, the rectangle returned is empty.
  4451.  
  4452. <p>Get this property's value with <a href="qwidget.html#visibleRect">visibleRect</a>().
  4453. </doc>
  4454. </property>
  4455. <property>
  4456.     <name>QWidget::width</name>
  4457.     <doc href="qwidget.html#width-prop"> <p>This property holds the width of the widget excluding any window frame.
  4458. <p>See the <a href="geometry.html">Window Geometry documentation</a>
  4459. for an overview of geometry issues with top-level widgets.
  4460. <p> <p>See also <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#height-prop">height</a> and <a href="qwidget.html#size-prop">size</a>.
  4461.  
  4462. <p>Get this property's value with <a href="qwidget.html#width">width</a>().
  4463. </doc>
  4464. </property>
  4465. <property>
  4466.     <name>QWidget::x</name>
  4467.     <doc href="qwidget.html#x-prop"> <p>This property holds the x coordinate of the widget relative to its parent including any window frame.
  4468. <p>See the <a href="geometry.html">Window Geometry documentation</a>
  4469. for an overview of geometry issues with top-level widgets.
  4470. <p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#y-prop">y</a> and <a href="qwidget.html#pos-prop">pos</a>.
  4471.  
  4472. <p>Get this property's value with <a href="qwidget.html#x">x</a>().
  4473. </doc>
  4474. </property>
  4475. <property>
  4476.     <name>QWidget::y</name>
  4477.     <doc href="qwidget.html#y-prop"> <p>This property holds the y coordinate of the widget relative to its parent and including any window frame.
  4478. <p>See the <a href="geometry.html">Window Geometry documentation</a>
  4479. for an overview of geometry issues with top-level widgets.
  4480. <p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#x-prop">x</a> and <a href="qwidget.html#pos-prop">pos</a>.
  4481.  
  4482. <p>Get this property's value with <a href="qwidget.html#y">y</a>().
  4483. </doc>
  4484. </property>
  4485. <property>
  4486.     <name>QWizard::titleFont</name>
  4487.     <doc href="qwizard.html#titleFont-prop">
  4488. <p>This property holds the font used for page titles.
  4489. <p>The default is <a href="qapplication.html#font">QApplication::font</a>().
  4490.  
  4491. <p>Set this property's value with <a href="qwizard.html#setTitleFont">setTitleFont</a>() and get this property's value with <a href="qwizard.html#titleFont">titleFont</a>().
  4492. </doc>
  4493. </property>
  4494. <property>
  4495.     <name>QWorkspace::scrollBarsEnabled</name>
  4496.     <doc href="qworkspace.html#scrollBarsEnabled-prop"> <p>This property holds whether the workspace provides scrollbars.
  4497. <p>If this property is set to TRUE, it is possible to resize child
  4498. windows over the right or the bottom edge out of the visible area
  4499. of the workspace. The workspace shows scrollbars to make it
  4500. possible for the user to access those windows. If this property is
  4501. set to FALSE (the default), resizing windows out of the visible
  4502. area of the workspace is not permitted.
  4503.  
  4504. <p>Set this property's value with <a href="qworkspace.html#setScrollBarsEnabled">setScrollBarsEnabled</a>() and get this property's value with <a href="qworkspace.html#scrollBarsEnabled">scrollBarsEnabled</a>().
  4505. </doc>
  4506. </property>
  4507. <property>
  4508.     <name>QtMultiLineEdit::alignment</name>
  4509.     <doc href="qtmultilineedit.html#alignment-prop">
  4510. <p>This property holds the alignment.
  4511. <p>Possible values are <a href="qt.html#AlignmentFlags-enum">AlignLeft</a>, <tt>Align(H)Center</tt> and <a href="qt.html#AlignmentFlags-enum">AlignRight</a>.
  4512. <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>.
  4513.  
  4514. <p>Set this property's value with <a href="qtmultilineedit.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qtmultilineedit.html#alignment">alignment</a>().
  4515. </doc>
  4516. </property>
  4517. <property>
  4518.     <name>QtMultiLineEdit::atBeginning</name>
  4519.     <doc href="qtmultilineedit.html#atBeginning-prop">
  4520. <p>This property holds whether the cursor is at the beginning.
  4521. <p>atBeginning() returns TRUE if the cursor is placed at the
  4522. beginning of the text.
  4523.  
  4524. <p>Get this property's value with <a href="qtmultilineedit.html#atBeginning">atBeginning</a>().
  4525. </doc>
  4526. </property>
  4527. <property>
  4528.     <name>QtMultiLineEdit::atEnd</name>
  4529.     <doc href="qtmultilineedit.html#atEnd-prop">
  4530. <p>This property holds whether the cursor is at the end.
  4531. <p>atEnd() returns TRUE if the cursor is placed at the end of the text.
  4532.  
  4533. <p>Get this property's value with <a href="qtmultilineedit.html#atEnd">atEnd</a>().
  4534. </doc>
  4535. </property>
  4536. <property>
  4537.     <name>QtMultiLineEdit::autoUpdate</name>
  4538.     <doc href="qtmultilineedit.html#autoUpdate-prop">
  4539. <p>This property holds whether auto update is enabled.
  4540. <p>autoUpdate() returns TRUE if the view updates itself automatically
  4541. whenever it is changed in some way.
  4542. <p> If <a href="qtmultilineedit.html#autoUpdate">autoUpdate</a>() is TRUE (this is the default) then the editor updates
  4543. itself automatically whenever it has changed in some way (generally,
  4544. when text has been inserted or deleted).
  4545. <p> If autoUpdate() is FALSE, the view does NOT repaint itself, or update
  4546. its internal state variables itself when it is changed.  This can be
  4547. useful to avoid flicker during large changes, and is singularly
  4548. useless otherwise: Disable auto-update, do the changes, re-enable
  4549. auto-update, and call <a href="qttableview.html#repaint">repaint</a>().
  4550. <p> <b>Warning:</b> Do not leave the view in this state for a long time
  4551. (i.e. between events ). If, for example, the user interacts with the
  4552. view when auto-update is off, strange things can happen.
  4553. <p> Setting auto-update to TRUE does not repaint the view, you must call
  4554. repaint() to do this (preferable repaint(FALSE) to avoid flicker).
  4555. <p> <p>See also <a href="qtmultilineedit.html#autoUpdate-prop">autoUpdate</a> and <a href="qttableview.html#repaint">repaint</a>().
  4556.  
  4557. <p> 
  4558. <p>Set this property's value with <a href="qtmultilineedit.html#setAutoUpdate">setAutoUpdate</a>() and get this property's value with <a href="qtmultilineedit.html#autoUpdate">autoUpdate</a>().
  4559. </doc>
  4560. </property>
  4561. <property>
  4562.     <name>QtMultiLineEdit::echoMode</name>
  4563.     <doc href="qtmultilineedit.html#echoMode-prop">
  4564. <p>This property holds the echo mode.
  4565. <p>
  4566. <p>Set this property's value with <a href="qtmultilineedit.html#setEchoMode">setEchoMode</a>() and get this property's value with <a href="qtmultilineedit.html#echoMode">echoMode</a>().
  4567. </doc>
  4568. </property>
  4569. <property>
  4570.     <name>QtMultiLineEdit::edited</name>
  4571.     <doc href="qtmultilineedit.html#edited-prop">
  4572. <p>This property holds whether the text had been edited.
  4573. <p>edited() returns the edited flag of the line edit.  If this returns FALSE,
  4574. the contents has not been changed since the construction of the
  4575. QtMultiLineEdit (or the last call to <a href="qtmultilineedit.html#setEdited">setEdited</a>( FALSE ), if any).  If
  4576. it returns TRUE, the contents have been edited, or setEdited( TRUE )
  4577. has been called.
  4578. <p> setEdited() sets the edited flag of this line edit to <em>e</em>.  The
  4579. edited flag is never read by QtMultiLineEdit, but is changed to TRUE
  4580. whenever the user changes its contents.
  4581. <p> This is useful e.g. for things that need to provide a default value,
  4582. but cannot find the default at once.  Just open the widget without the
  4583. best default and when the default is known, check the <a href="qtmultilineedit.html#edited">edited</a>() return
  4584. value and set the line edit's contents if the user has not started
  4585. editing the line edit.  Another example is to detect whether the
  4586. contents need saving.
  4587. <p> 
  4588. <p>Set this property's value with <a href="qtmultilineedit.html#setEdited">setEdited</a>() and get this property's value with <a href="qtmultilineedit.html#edited">edited</a>().
  4589. </doc>
  4590. </property>
  4591. <property>
  4592.     <name>QtMultiLineEdit::hMargin</name>
  4593.     <doc href="qtmultilineedit.html#hMargin-prop">
  4594. <p>This property holds the horizontal margin The horizontal margin current set. The default is 3.
  4595. <p>
  4596. <p>Set this property's value with <a href="qtmultilineedit.html#setHMargin">setHMargin</a>() and get this property's value with <a href="qtmultilineedit.html#hMargin">hMargin</a>().
  4597. </doc>
  4598. </property>
  4599. <property>
  4600.     <name>QtMultiLineEdit::length</name>
  4601.     <doc href="qtmultilineedit.html#length-prop">
  4602. <p>This property holds the length of the text.
  4603. <p>
  4604. <p>Get this property's value with <a href="qtmultilineedit.html#length">length</a>().
  4605. </doc>
  4606. </property>
  4607. <property>
  4608.     <name>QtMultiLineEdit::maxLength</name>
  4609.     <doc href="qtmultilineedit.html#maxLength-prop">
  4610. <p>This property holds the maximum length of the text.
  4611. <p>The currently set text length limit, or -1 if there is
  4612. no limit (this is the default).
  4613. <p> 
  4614. <p>Set this property's value with <a href="qtmultilineedit.html#setMaxLength">setMaxLength</a>() and get this property's value with <a href="qtmultilineedit.html#maxLength">maxLength</a>().
  4615. </doc>
  4616. </property>
  4617. <property>
  4618.     <name>QtMultiLineEdit::maxLineWidth</name>
  4619.     <doc href="qtmultilineedit.html#maxLineWidth-prop">
  4620. <p>This property holds the maximum line width in pixels Returns the width in pixels of the longest text line in this editor.
  4621. <p>
  4622. <p>Get this property's value with <a href="qtmultilineedit.html#maxLineWidth">maxLineWidth</a>().
  4623. </doc>
  4624. </property>
  4625. <property>
  4626.     <name>QtMultiLineEdit::maxLines</name>
  4627.     <doc href="qtmultilineedit.html#maxLines-prop">
  4628. <p>This property holds the maximum number of lines The currently set line limit, or -1 if there is no limit (the default).
  4629. <p>Note that excess lines are deleted from the <em>bottom</em> of the
  4630. lines. If you want teletype behaviour with lines disappearing
  4631. from the <em>top</em> as the limit is exceed, you probably just want
  4632. to use <a href="qtmultilineedit.html#removeLine">removeLine</a>(0) prior to adding an excess line.
  4633. <p> 
  4634. <p>Set this property's value with <a href="qtmultilineedit.html#setMaxLines">setMaxLines</a>() and get this property's value with <a href="qtmultilineedit.html#maxLines">maxLines</a>().
  4635. </doc>
  4636. </property>
  4637. <property>
  4638.     <name>QtMultiLineEdit::numLines</name>
  4639.     <doc href="qtmultilineedit.html#numLines-prop">
  4640. <p>This property holds the number of lines in the multi-line edit.
  4641. <p>numLines() returns the number of lines in the editor. The count
  4642. includes any empty lines at top and bottom, so for an empty editor
  4643. this method will return 1.
  4644.  
  4645. <p>Get this property's value with <a href="qtmultilineedit.html#numLines">numLines</a>().
  4646. </doc>
  4647. </property>
  4648. <property>
  4649.     <name>QtMultiLineEdit::overWriteMode</name>
  4650.     <doc href="qtmultilineedit.html#overWriteMode-prop">
  4651. <p>This property holds the overwrite mode.
  4652. <p>
  4653. <p>Set this property's value with <a href="qtmultilineedit.html#setOverwriteMode">setOverwriteMode</a>() and get this property's value with <a href="qtmultilineedit.html#isOverwriteMode">isOverwriteMode</a>().
  4654. </doc>
  4655. </property>
  4656. <property>
  4657.     <name>QtMultiLineEdit::readOnly</name>
  4658.     <doc href="qtmultilineedit.html#readOnly-prop">
  4659. <p>This property holds whether the multi-line edit is read-only.
  4660. <p>
  4661. <p>Set this property's value with <a href="qtmultilineedit.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qtmultilineedit.html#isReadOnly">isReadOnly</a>().
  4662. </doc>
  4663. </property>
  4664. <property>
  4665.     <name>QtMultiLineEdit::text</name>
  4666.     <doc href="qtmultilineedit.html#text-prop">
  4667. <p>This property holds the multi-line edit's text.
  4668. <p>
  4669. <p>Set this property's value with <a href="qtmultilineedit.html#setText">setText</a>() and get this property's value with <a href="qtmultilineedit.html#text">text</a>().
  4670. </doc>
  4671. </property>
  4672. <property>
  4673.     <name>QtMultiLineEdit::undoDepth</name>
  4674.     <doc href="qtmultilineedit.html#undoDepth-prop">
  4675. <p>This property holds the undo depth.
  4676. <p>The maximum number of operations that can be stored on the undo stack.
  4677. <p> <p>See also <a href="qtmultilineedit.html#undoDepth-prop">undoDepth</a>.
  4678.  
  4679. <p>Set this property's value with <a href="qtmultilineedit.html#setUndoDepth">setUndoDepth</a>() and get this property's value with <a href="qtmultilineedit.html#undoDepth">undoDepth</a>().
  4680. </doc>
  4681. </property>
  4682. <property>
  4683.     <name>QtMultiLineEdit::undoEnabled</name>
  4684.     <doc href="qtmultilineedit.html#undoEnabled-prop">
  4685. <p>This property holds whether undo is enabled.
  4686. <p>
  4687. <p>Set this property's value with <a href="qtmultilineedit.html#setUndoEnabled">setUndoEnabled</a>() and get this property's value with <a href="qtmultilineedit.html#isUndoEnabled">isUndoEnabled</a>().
  4688. </doc>
  4689. </property>
  4690. <property>
  4691.     <name>QtMultiLineEdit::wordWrap</name>
  4692.     <doc href="qtmultilineedit.html#wordWrap-prop">
  4693. <p>This property holds the word wrap mode.
  4694. <p>By default, wrapping keeps words intact. To allow breaking within
  4695. words, set the wrap policy to <a href="qtmultilineedit.html#WrapPolicy-enum">Anywhere</a> (see <a href="qtmultilineedit.html#setWrapPolicy">setWrapPolicy</a>() ).
  4696. <p> The default wrap mode is <a href="qtmultilineedit.html#WordWrap-enum">NoWrap</a>.
  4697. <p> <p>See also <a href="qtmultilineedit.html#wordWrap-prop">wordWrap</a>, <a href="qtmultilineedit.html#wrapColumnOrWidth-prop">wrapColumnOrWidth</a> and <a href="qtmultilineedit.html#wrapPolicy-prop">wrapPolicy</a>.
  4698.  
  4699. <p>Set this property's value with <a href="qtmultilineedit.html#setWordWrap">setWordWrap</a>() and get this property's value with <a href="qtmultilineedit.html#wordWrap">wordWrap</a>().
  4700. </doc>
  4701. </property>
  4702. <property>
  4703.     <name>QtMultiLineEdit::wrapColumnOrWidth</name>
  4704.     <doc href="qtmultilineedit.html#wrapColumnOrWidth-prop">
  4705. <p>This property holds the wrap width in columns or pixels The wrap column or wrap width, depending on the word wrap mode.
  4706. <p>Set this property's value with <a href="qtmultilineedit.html#setWrapColumnOrWidth">setWrapColumnOrWidth</a>() and get this property's value with <a href="qtmultilineedit.html#wrapColumnOrWidth">wrapColumnOrWidth</a>().
  4707. <p><p>See also <a href="qtmultilineedit.html#wordWrap-prop">wordWrap</a> and <a href="qtmultilineedit.html#wrapColumnOrWidth-prop">wrapColumnOrWidth</a>.
  4708.  
  4709. </doc>
  4710. </property>
  4711. <property>
  4712.     <name>QtMultiLineEdit::wrapPolicy</name>
  4713.     <doc href="qtmultilineedit.html#wrapPolicy-prop">
  4714. <p>This property holds the wrap policy mode The default is <a href="qtmultilineedit.html#WrapPolicy-enum">AtWhiteSpace</a>.
  4715. <p>
  4716. <p>Set this property's value with <a href="qtmultilineedit.html#setWrapPolicy">setWrapPolicy</a>() and get this property's value with <a href="qtmultilineedit.html#wrapPolicy">wrapPolicy</a>().
  4717. </doc>
  4718. </property>
  4719. </PROP>
  4720.